Page MenuHomeFreeBSD

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

Authored by rene on Mar 30 2021, 8:03 PM.
Tags
None
Referenced Files
Unknown Object (File)
Wed, Mar 27, 3:26 PM
Unknown Object (File)
Tue, Mar 26, 10:45 PM
Unknown Object (File)
Jan 12 2024, 5:15 AM
Unknown Object (File)
Dec 20 2023, 1:56 AM
Unknown Object (File)
Dec 2 2023, 9:55 PM
Unknown Object (File)
Nov 21 2023, 9:07 PM
Unknown Object (File)
Nov 20 2023, 2:23 AM
Unknown Object (File)
Nov 20 2023, 2:23 AM
Subscribers

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 38193
Build 35082: arc lint + arc unit

Event Timeline

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

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
75

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.

83

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
69

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

83

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
69

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

share/man/man7/ports.7
83

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
69

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
69

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.

82

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
81

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

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

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
83

No :)

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