Page MenuHomeFreeBSD

Explain branches in ports(7).
ClosedPublic

Authored by trasz on Feb 11 2019, 1:49 PM.

Details

Summary

Add explanation of branches to the ports(7) man page.

Diff Detail

Repository
rS 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

trasz created this revision.Feb 11 2019, 1:49 PM
trasz updated this revision to Diff 53784.Feb 11 2019, 2:36 PM

Improve things a bit.

matthew added inline comments.
share/man/man7/ports.7
81–83 ↗(On Diff #53784)

What 'quarterly' directory do you mean here? The subdirectory in the SVN repo is 'branches', like so:

https://svnweb.freebsd.org/ports/branches/

There's a 'quarterly' directory on the pkg repos.

matthew added inline comments.Feb 11 2019, 2:51 PM
share/man/man7/ports.7
69 ↗(On Diff #53784)

The quarterly branches aren't necessarily 'better tested' than ports HEAD. They're just a slower moving target: instead of essentially daily updates with HEAD, you only get updates once every three months or whenever there's a security fix or a significant fix that eg. takes something from not-working to working.

To put it another way: there's no extra QA gets done around branching each quarter. In fact, certain intrusive changes may be held from implementation until a quarter day so that the diff between HEAD and quarterly can be kept workably small.

trasz updated this revision to Diff 53785.Feb 11 2019, 2:55 PM

More updates.

Harbormaster completed remote builds in B22436: Diff 53785.
trasz updated this revision to Diff 53787.Feb 11 2019, 3:07 PM

Explain quarterly branches a bit better.

Harbormaster completed remote builds in B22438: Diff 53787.
trasz marked 2 inline comments as done.Feb 11 2019, 3:08 PM
matthew accepted this revision.Feb 11 2019, 3:10 PM

LGTM

This revision is now accepted and ready to land.Feb 11 2019, 3:10 PM
This revision was automatically updated to reflect the committed changes.