From owner-svn-doc-head@FreeBSD.ORG Tue Feb 4 14:09:03 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 57A95234; Tue, 4 Feb 2014 14:09:03 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 3F78A116F; Tue, 4 Feb 2014 14:09:03 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s14E93BU088844; Tue, 4 Feb 2014 14:09:03 GMT (envelope-from mat@svn.freebsd.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s14E92Ki088839; Tue, 4 Feb 2014 14:09:02 GMT (envelope-from mat@svn.freebsd.org) Message-Id: <201402041409.s14E92Ki088839@svn.freebsd.org> From: Mathieu Arnold Date: Tue, 4 Feb 2014 14:09:02 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 04 Feb 2014 14:09:03 -0000 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 Upgrade the copied port to the new version. - Remember to change the - LATEST_LINK so there are no + Remember to add or change the + PKGNAMEPREFIX or + PKGNAMESUFFIX so there are no duplicate ports with the same name. In some rare cases it may be necessary to change the - PORTNAME instead of - LATEST_LINK, 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 + PORTNAME instead of adding + PKGNAMEPREFIX or + PKGNAMESUFFIX, 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 textproc/libxml to textproc/libxml2. In most - cases, changing LATEST_LINK - should suffice. + cases, adding or changing + PKGNAMEPREFIX or + PKGNAMESUFFIX should + suffice. 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 them part of PORTNAME. - - <varname>LATEST_LINK</varname> - - 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, independent ports, although they may - all have the same PORTNAME, - PKGNAMEPREFIX, and 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 - 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 scope of this handbook's recommendations; we only tell - you how to specify the other ports' versions after you have - picked a main one. - - Package Naming Conventions @@ -1341,9 +1306,8 @@ PORTEPOCH= 1 PORTNAME, as the www/apache* ports do; in that case, different versions (and different index entries) are - distinguished by the PKGNAMEPREFIX, - PKGNAMESUFFIX, and - LATEST_LINK values. + distinguished by the PKGNAMEPREFIX + and PKGNAMESUFFIX values. 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.)

-

  • 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.)

    • -