git: 554d62acd0 - main - handbook/ports: Note that portsnap only tracks the main branch.

[Ceri Davies]

The branch main has been updated by ceri:

URL: https://cgit.FreeBSD.org/doc/commit/?id=554d62acd0880b3f8f9ad6f10d3f302915e7a37a

commit 554d62acd0880b3f8f9ad6f10d3f302915e7a37a
Author:     Ceri Davies <ceri at FreeBSD.org>
AuthorDate: 2021-06-29 20:32:05 +0000
Commit:     Ceri Davies <ceri at FreeBSD.org>
CommitDate: 2021-06-29 20:32:05 +0000

    handbook/ports: Note that portsnap only tracks the main branch.
    
    PR:             251279
    Reported by:    Fred <fjs.usa01 at gmail.com>
    Reviewed by:    crees
    Obtained from:  bjk
    Differential Revision:  https://reviews.freebsd.org/D27843
---
 documentation/content/en/books/handbook/ports/_index.adoc | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
index 38d84a4154..d5dda2a9ab 100644
--- a/documentation/content/en/books/handbook/ports/_index.adoc
+++ b/documentation/content/en/books/handbook/ports/_index.adoc
@@ -670,6 +670,13 @@ This is a fast and user-friendly tool for retrieving the Ports Collection and is
 This utility connects to a FreeBSD site, verifies the secure key, and downloads a new copy of the Ports Collection.
 The key is used to verify the integrity of all downloaded files.
 
+Note that Portsnap updates are generated from a snapshot of the main
+branch of the Ports Collection and cannot be configured to use a
+different branch (for example, `quarterly`).
+If it is necessary to use a different branch of the Ports Collection
+(for instance as referenced earlier in conjunction with binary
+packages), then the <<ports-using-git-method,Git method>> must be used.
+
 . To download a compressed snapshot of the Ports Collection into [.filename]#/var/db/portsnap#:
 +
 [source,shell]