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

Reviewed by:	matthew@, freebsd@mhka.no
MFC after:	2 weeks
Sponsored by:	DARPA, AFRL
Differential Revision:	https://reviews.freebsd.org/D19146
This commit is contained in:
Edward Tomasz Napierala 2019-02-11 20:46:32 +00:00
parent 804a6541db
commit 22427daf7e
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=344021

View file

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd January 8, 2019
.Dd February 11, 2019
.Dt PORTS 7
.Os
.Sh NAME
@ -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 .
.Pp
The ports tree, typically located at
.Pa /usr/ports ,
@ -62,6 +60,55 @@ Afterwards,
.Dq Li "make install"
installs the application.
.Pp
The
.Fx
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.
The
.Em head
branch can be installed or updated using either
.Xr portsnap 8 ,
or from Subversion repository at:
.Pp
.Lk https://svn.FreeBSD.org/ports/head
.Pp
The
.Em quarterly
branches can be found in Subversion in the
.Fa branches/
subdirectory, eg:
.Pp
.Lk https://svn.FreeBSD.org/ports/branches/2019Q1
.Pp
It is generally a good idea to use the
.Nm
branch that matches the
.Xr pkg 8
repository being used.
By default, for
.Fx CURRENT
the
.Xr pkg 8
is configured to install packages built from the
.Em head
branch, while for
.Fx STABLE
or RELEASE versions it is configured to install packages built from
the latest
.Em quarterly
branch.
Currently configured
.Xr pkg 8
repository can be verified by looking at the
.Em url
field in
.Cm pkg -vv
output.
.Pp
For more information about using ports, see the
.Dq "Packages and Ports" section
in