Changeset View
Standalone View
share/man/man7/ports.7
Show All 19 Lines | |||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | ||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd February 18, 2021 | .Dd March 30, 2021 | ||||
.Dt PORTS 7 | .Dt PORTS 7 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ports | .Nm ports | ||||
.Nd contributed applications | .Nd contributed applications | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Fx | .Fx | ||||
Show All 22 Lines | |||||
Afterwards, | Afterwards, | ||||
.Dq Li "make install" | .Dq Li "make install" | ||||
installs the application. | installs the application. | ||||
.Pp | .Pp | ||||
The | The | ||||
.Fx | .Fx | ||||
Ports Collection is maintained in several branches, which differ mostly | Ports Collection is maintained in several branches, which differ mostly | ||||
by versions of software provided: the | by versions of software provided: the | ||||
.Em head | .Em main | ||||
branch contains all the latest changes, while the | (also known as head) branch contains all the latest changes, while the | ||||
gjb: I would remove the "(also known as head)", since we are moving away from that terminology.
I… | |||||
impUnsubmitted Done Inline ActionsMaybe "formerly known as head" if you don't remove it. imp: Maybe "formerly known as head" if you don't remove it.
| |||||
lwhsuUnsubmitted Done Inline ActionsI suggest latest because we use that in /etc/pkg/FreeBSD.conf lwhsu: I suggest `latest` because we use that in /etc/pkg/FreeBSD.conf | |||||
gjbUnsubmitted Done Inline ActionsNot for releases, though. The quarterly branch is used in /etc/pkg/FreeBSD.conf there. gjb: Not for releases, though. The quarterly branch is used in /etc/pkg/FreeBSD.conf there. | |||||
lwhsuUnsubmitted Done Inline ActionsYes which branches are used by which version is explained below. I mean here we can explain that the source of pkg's latest branch is ports' main branch. lwhsu: Yes which branches are used by which version is explained below. I mean here we can explain… | |||||
.Em quarterly | .Em quarterly | ||||
branches only provide critical fixes. | branches only provide critical fixes. | ||||
The | The | ||||
.Em head | .Em main | ||||
branch can be installed or updated from the Subversion repository located at: | branch can be installed or updated from the Git repository located at: | ||||
.Pp | .Pp | ||||
.Lk https://svn.FreeBSD.org/ports/head | .Lk https://cgit.FreeBSD.org/ports/tree/?h=main | ||||
lwhsuUnsubmitted Done Inline ActionsI think https://svn.freebsd.org/ports/head is a "check out" URL so the counterpart in git would be https://git.freebsd.org/ports , and maybe mention the -b main parameter when doing git clone. lwhsu: I think https://svn.freebsd.org/ports/head is a "check out" URL so the counterpart in git would… | |||||
.Pp | .Pp | ||||
The | The | ||||
.Em quarterly | .Em quarterly | ||||
branches can be found in Subversion in the | branches can be found in Git in the | ||||
.Pa branches/ | .Pa branches/ | ||||
subdirectory, eg: | subdirectory, eg: | ||||
Done Inline Actionsmaybe "branches can be found in Git repository's" lwhsu: maybe "branches can be found in Git repository's" | |||||
.Pp | .Pp | ||||
Done Inline Actionsit's nice to explain what yyyy and n means. lwhsu: it's nice to explain what yyyy and n means. | |||||
.Lk https://svn.FreeBSD.org/ports/branches/2019Q1 | .Lk https://cgit.FreeBSD.org/ports/tree/?h=branches%2F2019Q1 | ||||
lwhsuUnsubmitted Done Inline ActionsSame here. lwhsu: Same here. | |||||
impUnsubmitted Done Inline ActionsI'd change this to 2019Q1 to 2021Q1 imp: I'd change this to 2019Q1 to 2021Q1
| |||||
lwhsuUnsubmitted Done Inline ActionsWe can explain more here, saying that the format is YYYYQN where YYYY is the year and N is the number of the quarter. lwhsu: We can explain more here, saying that the format is `YYYYQN` where YYYY is the year and N is… | |||||
Done Inline ActionsDo we really need the branch/ prefix? It had a meaning when we were using subversion, but now, branches are branches, not subdirectories that we decided to use as a branch. mat: Do we **really** need the `branch/` prefix? It had a meaning when we were using subversion… | |||||
Done Inline ActionsNo :) rene: No :) | |||||
.Pp | .Pp | ||||
It is generally a good idea to use the | It is generally a good idea to use the | ||||
.Nm | .Nm | ||||
branch that matches the | branch that matches the | ||||
.Xr pkg 8 | .Xr pkg 8 | ||||
repository being used. | repository being used. | ||||
By default, for | By default, for | ||||
.Fx CURRENT | .Fx CURRENT | ||||
the | the | ||||
.Xr pkg 8 | .Xr pkg 8 | ||||
is configured to install packages built from the | is configured to install packages built from the | ||||
.Em head | .Em main | ||||
branch, while for | branch, while for | ||||
.Fx STABLE | .Fx STABLE | ||||
or RELEASE versions it is configured to install packages built from | or RELEASE versions it is configured to install packages built from | ||||
the latest | the latest | ||||
.Em quarterly | .Em quarterly | ||||
branch. | branch. | ||||
Currently configured | Currently configured | ||||
.Xr pkg 8 | .Xr pkg 8 | ||||
▲ Show 20 Lines • Show All 576 Lines • Show Last 20 Lines |
I would remove the "(also known as head)", since we are moving away from that terminology.
I will not complain either way, though.
But I would use '.Po/.Pc' macros instead of hard-coded parenthesis.