Bug 228333 - Add a section about switching pkg from the quarterly branch to the latest branch
Summary: Add a section about switching pkg from the quarterly branch to the latest branch
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc mailing list
Keywords: easy, feature, needs-qa
Depends on:
Reported: 2018-05-18 13:34 UTC by Mateusz Piotrowski
Modified: 2018-12-23 12:20 UTC (History)
2 users (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Mateusz Piotrowski freebsd_committer 2018-05-18 13:34:42 UTC
Although this information is already present in manual pages, I think that FreeBSD users would benefit from including a note on how to switch to the latest branch.

This question is being being asked all the time on StackExchange and IRC channels. Sometimes even every few days.

Also, I'd include a short note about how often the official FreeBSD package repository is updated. People ask all the time why the new version of a port, which has just been updated, is not yet available to download via pkg.
Comment 1 Jack-Benny Persson 2018-11-03 03:26:45 UTC
Information on how to follow the quarterly portstree would also be useful. Perhaps even more important to be honest? Since the quarterly packages are default nowadays, and considered more stable, then it would only make sense to also follow the quarterly ports. Many users find them self in a mess when the ports and the packages are "out of sync".

I was thinking of writing an example paragraph for this for the Handbook. But I realized that I don't think there's any official way of doing it? There are some shell scripts on the net that does help with it, but it's not something that's shipped with FreeBSD, or something that can be installed from either ports or packages.

For starters the Handbook should at least mention that there are two branches of both packages and ports.
Comment 2 Mateusz Piotrowski freebsd_committer 2018-11-04 00:00:26 UTC
FWIW, I've posted a answer to a similar question on Stack Exchange: https://unix.stackexchange.com/a/433876/128489
Comment 3 Benedict Reuschling freebsd_committer 2018-12-23 12:20:39 UTC
Could you create a patch for the handbook with the changes that you have in mind? I'd be happy to review. Thanks.