Date: Tue, 4 Feb 2014 14:09:02 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43748 - in head/en_US.ISO8859-1: articles/committers-guide books/porters-handbook htdocs/portmgr Message-ID: <201402041409.s14E92Ki088839@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat (ports committer) Date: Tue Feb 4 14:09:02 2014 New Revision: 43748 URL: http://svnweb.freebsd.org/changeset/doc/43748 Log: Remove LATEST_LINK mentions, nobody should use it, ever. Sponsored by: Absolight Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml head/en_US.ISO8859-1/books/porters-handbook/book.xml head/en_US.ISO8859-1/htdocs/portmgr/qa.xml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Tue Feb 4 14:03:59 2014 (r43747) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Tue Feb 4 14:09:02 2014 (r43748) @@ -4014,22 +4014,26 @@ MFC after: 1 month</programlist <step> <para>Upgrade the copied port to the new version. - Remember to change the - <varname>LATEST_LINK</varname> so there are no + Remember to add or change the + <varname>PKGNAMEPREFIX</varname> or + <varname>PKGNAMESUFFIX</varname> so there are no duplicate ports with the same name. In some rare cases it may be necessary to change the - <varname>PORTNAME</varname> instead of - <varname>LATEST_LINK</varname>, but this should - only be done when it is really needed — - e.g., using an existing port as the base for a - very similar program with a different name, or - upgrading a port to a new upstream version which - actually changes the distribution name, like the - transition from + <varname>PORTNAME</varname> instead of adding + <varname>PKGNAMEPREFIX</varname> or + <varname>PKGNAMESUFFIX</varname>, but this + should only be done when it is really needed + — e.g., using an existing port as the base + for a very similar program with a different + name, or upgrading a port to a new upstream + version which actually changes the distribution + name, like the transition from <filename>textproc/libxml</filename> to <filename>textproc/libxml2</filename>. In most - cases, changing <varname>LATEST_LINK</varname> - should suffice.</para> + cases, adding or changing + <varname>PKGNAMEPREFIX</varname> or + <varname>PKGNAMESUFFIX</varname> should + suffice.</para> </step> <step> Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Tue Feb 4 14:03:59 2014 (r43747) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Tue Feb 4 14:09:02 2014 (r43748) @@ -1238,41 +1238,6 @@ PORTEPOCH= 1</programlisting> them part of <varname>PORTNAME</varname>.</para> </sect2> - <sect2> - <title><varname>LATEST_LINK</varname></title> - - <para><varname>LATEST_LINK</varname> 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, independent ports, although they may - all have the same <varname>PORTNAME</varname>, - <varname>PKGNAMEPREFIX</varname>, and even - <varname>PKGNAMESUFFIX</varname>. In those cases, the - optional <varname>LATEST_LINK</varname> variable should be - set to a different value for all ports except the - <quote>main</quote> one — 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 <varname>NO_LATEST_LINK</varname>, 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 — - <quote>most popular</quote>, <quote>best supported</quote>, - <quote>least patched</quote>, and so on — is outside - the scope of this handbook's recommendations; we only tell - you how to specify the other ports' versions after you have - picked a <quote>main</quote> one.</para> - </sect2> - <sect2 xml:id="porting-pkgname"> <title>Package Naming Conventions</title> @@ -1341,9 +1306,8 @@ PORTEPOCH= 1</programlisting> <varname>PORTNAME</varname>, as the <filename>www/apache*</filename> ports do; in that case, different versions (and different index entries) are - distinguished by the <varname>PKGNAMEPREFIX</varname>, - <varname>PKGNAMESUFFIX</varname>, and - <varname>LATEST_LINK</varname> values.</para> + distinguished by the <varname>PKGNAMEPREFIX</varname> + and <varname>PKGNAMESUFFIX</varname> values.</para> </listitem> <listitem> Modified: head/en_US.ISO8859-1/htdocs/portmgr/qa.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/portmgr/qa.xml Tue Feb 4 14:03:59 2014 (r43747) +++ head/en_US.ISO8859-1/htdocs/portmgr/qa.xml Tue Feb 4 14:09:02 2014 (r43748) @@ -153,14 +153,6 @@ two main categories: the port. (This email is not automated but it should be sent as a courtesy.)</p></li> - <li><p>a list of ports that do not set NO_LATEST_LINK. (Ports - that have a stable version, and a development version, will - generally have the development version set to a later revision. - If it is desirable that users should install the stable version - from packages, rather than the development version, this flag - should be set; otherwise, users will get the latest version by - default.)</p></li> - </ul> </li>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402041409.s14E92Ki088839>