From 312682a9454cbd4294ae7c08406de3e64bd45b58 Mon Sep 17 00:00:00 2001 From: Erwin Lansing Date: Thu, 29 Sep 2011 07:37:09 +0000 Subject: [PATCH] Flesh out the LATEST_LINK section a bit more and also mention NO_LATEST_LINK Suggested by: gerald --- en_US.ISO8859-1/books/porters-handbook/book.sgml | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 8a564be8d2..490d14c11d 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -1094,6 +1094,14 @@ PORTEPOCH= 1 <makevar>LATEST_LINK</makevar> + LATEST_LINK is used during package building + to determine a shortened name to create links that can be used by + pkg_add -r. This makes it possible to, for + example, install the latest perl version by running + pkg_add -r perl without knowing the exact + version number. This name needs to be unique and obvious to + users. + 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 even PKGNAMESUFFIX. In those cases, the optional LATEST_LINK variable should be set to a different value for all ports except the main - one — see the editors/vim5 and - editors/vim ports, and the + one — see the lang/gcc46 and + lang/gcc ports, and the www/apache* family for examples of its use. + By setting NO_LATEST_LINK, no link will be + generated, which may be an option for all but the + main version. Note that how to choose a main version — most popular, best supported, least patched, and so on — is outside the