Page MenuHomeFreeBSD

Convert the ports(7) manual page to Git.
ClosedPublic

Authored by rene on Mar 30 2021, 8:03 PM.

Diff Detail

Repository
R10 FreeBSD src repository
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

rene requested review of this revision.Mar 30 2021, 8:03 PM
gjb added inline comments.
share/man/man7/ports.7
67

I would remove the "(also known as head)", since we are moving away from that terminology.

I will not complain either way, though.

But I would use '.Po/.Pc' macros instead of hard-coded parenthesis.

This revision is now accepted and ready to land.Mar 30 2021, 8:08 PM
share/man/man7/ports.7
77–81

I think https://svn.freebsd.org/ports/head is a "check out" URL so the counterpart in git would be https://git.freebsd.org/ports , and maybe mention the -b main parameter when doing git clone.

95

Same here.

I'm good with this as it is, but if you make my suggested changes I'm good with it too :)

share/man/man7/ports.7
67

Maybe "formerly known as head" if you don't remove it.

95

I'd change this to 2019Q1 to 2021Q1

  • Remove obsolete "head" terminology.
This revision now requires review to proceed.Mar 30 2021, 8:13 PM
share/man/man7/ports.7
67

I suggest latest because we use that in /etc/pkg/FreeBSD.conf

share/man/man7/ports.7
95

We can explain more here, saying that the format is YYYYQN where YYYY is the year and N is the number of the quarter.

share/man/man7/ports.7
67

Not for releases, though. The quarterly branch is used in /etc/pkg/FreeBSD.conf there.

rene marked 3 inline comments as done.
  • Update the section about branches.
share/man/man7/ports.7
67

Yes which branches are used by which version is explained below. I mean here we can explain that the source of pkg's latest branch is ports' main branch.

85

it's nice to explain what yyyy and n means.

  • Use the correct git URL
This revision is now accepted and ready to land.Mar 30 2021, 8:47 PM
rene marked 7 inline comments as done.
  • Better explain yyyyQn
This revision now requires review to proceed.Mar 30 2021, 8:51 PM
This revision is now accepted and ready to land.Mar 30 2021, 8:57 PM
share/man/man7/ports.7
85–93

maybe "branches can be found in Git repository's"

mat added inline comments.
share/man/man7/ports.7
95

Do we really need the branch/ prefix? It had a meaning when we were using subversion, but now, branches are branches, not subdirectories that we decided to use as a branch.

rene marked 2 inline comments as done.Apr 6 2021, 8:25 PM
rene added inline comments.
share/man/man7/ports.7
95

No :)

This revision was automatically updated to reflect the committed changes.
rene marked an inline comment as done.