os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Flesh out the LATEST_LINK section a bit more and also mention NO_LATEST_LINK

Browse source 
Suggested by:	gerald
This commit is contained in:
Erwin Lansing 2011-09-29 07:37:09 +00:00
parent 668ce1be98
commit 312682a945
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=37753
1 changed files with 13 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

15
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -1094,6 +1094,14 @@ PORTEPOCH= 1</programlisting>
<sect2>
<title><makevar>LATEST_LINK</makevar></title>
<para><makevar>LATEST_LINK</makevar> is used during package building
to determine a shortened name to create links that can be used by
<command>pkg_add -r</command>. This makes it possible to, for
example, install the latest perl version by running
<command>pkg_add -r perl</command> without knowing the exact
version number. This name needs to be unique and obvious to
users.</para>
<para>In some cases, several versions of a program may be present in
the ports collection at the same time. Both the index build and
the package build system need to be able to see them as different,
@ -1102,9 +1110,12 @@ PORTEPOCH= 1</programlisting>
even <makevar>PKGNAMESUFFIX</makevar>. In those cases, the
optional <makevar>LATEST_LINK</makevar> variable should be set to
a different value for all ports except the <quote>main</quote>
one &mdash; see the <filename>editors/vim5</filename> and
<filename>editors/vim</filename> ports, and the
one &mdash; see the <filename>lang/gcc46</filename> and
<filename>lang/gcc</filename> ports, and the
<filename>www/apache*</filename> family for examples of its use.
By setting <makevar>NO_LATEST_LINK</makevar>, no link will be
generated, which may be an option for all but the
<quote>main</quote> version.
Note that how to choose a <quote>main</quote> version &mdash;
<quote>most popular</quote>, <quote>best supported</quote>,
<quote>least patched</quote>, and so on &mdash; is outside the