svn commit: r344021 - head/share/man/man7

Edward Tomasz Napierala trasz at
Mon Feb 11 20:46:33 UTC 2019

Author: trasz
Date: Mon Feb 11 20:46:32 2019
New Revision: 344021

  Add explanation of branches to the ports(7) man page.
  Reviewed by:	matthew@, freebsd at
  MFC after:	2 weeks
  Sponsored by:	DARPA, AFRL
  Differential Revision:


Modified: head/share/man/man7/ports.7
--- head/share/man/man7/ports.7	Mon Feb 11 19:08:03 2019	(r344020)
+++ head/share/man/man7/ports.7	Mon Feb 11 20:46:32 2019	(r344021)
@@ -25,7 +25,7 @@
 .\" $FreeBSD$
-.Dd January 8, 2019
+.Dd February 11, 2019
 .Dt PORTS 7
@@ -38,8 +38,6 @@ Ports Collection
 offers a simple way to compile and install third party applications.
 It is also used to build packages, to be installed using
 .Xr pkg 8 .
-It can be installed and updated using
-.Xr portsnap 8 .
 The ports tree, typically located at
 .Pa /usr/ports ,
@@ -61,6 +59,55 @@ the port depends on in order to build and work.
 .Dq Li "make install"
 installs the application.
+Ports Collection is maintained in several branches, which differ mostly
+by versions of software provided: the
+.Em head
+branch contains all the latest changes, while the
+.Em quarterly
+branches only provide critical fixes.
+.Em head
+branch can be installed or updated using either
+.Xr portsnap 8 ,
+or from Subversion repository at:
+.Em quarterly
+branches can be found in Subversion in the
+.Fa branches/
+subdirectory, eg:
+It is generally a good idea to use the
+branch that matches the
+.Xr pkg 8
+repository being used.
+By default, for
+.Xr pkg 8
+is configured to install packages built from the
+.Em head
+branch, while for
+or RELEASE versions it is configured to install packages built from
+the latest
+.Em quarterly
+Currently configured
+.Xr pkg 8
+repository can be verified by looking at the
+.Em url
+field in
+.Cm pkg -vv
 For more information about using ports, see the
 .Dq "Packages and Ports" section

More information about the svn-src-all mailing list