From owner-freebsd-doc@FreeBSD.ORG Tue Aug 10 14:10:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BABED16A4CE for ; Tue, 10 Aug 2004 14:10:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9A22F43D39 for ; Tue, 10 Aug 2004 14:10:23 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i7AEANar018002 for ; Tue, 10 Aug 2004 14:10:23 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i7AEANWJ018001; Tue, 10 Aug 2004 14:10:23 GMT (envelope-from gnats) Date: Tue, 10 Aug 2004 14:10:23 GMT Message-Id: <200408101410.i7AEANWJ018001@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Oliver Eikemeier Subject: Re: docs/66775: Clarification that port names should not contain version numbers X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Oliver Eikemeier List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Aug 2004 14:10:23 -0000 The following reply was made to PR docs/66775; it has been noted by GNATS. From: Oliver Eikemeier To: Aasmund Eikli Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/66775: Clarification that port names should not contain version numbers Date: Tue, 10 Aug 2004 16:02:21 +0200 Aasmund Eikli wrote: > From: Aasmund Eikli > To: Peter Pentchev > Cc: bug-followup@freebsd.org > Subject: Re: docs/66775: Clarification that port names should not > contain > version numbers > Date: Tue, 10 Aug 2004 11:13:00 +0200 > > Looks good! > > A very minor point though, shouldnt "not duplicate ports" be "no > duplicate ports"? > [...] > Peter Pentchev wrote: >> >> Index: doc/en_US.ISO8859-1/articles/committers-guide/article.sgml >> =================================================================== >> RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/committers- >> guide/article.sgml,v >> retrieving revision 1.207 >> diff -u -r1.207 article.sgml >> --- doc/en_US.ISO8859-1/articles/committers-guide/article.sgml 8 Aug 2004 >> 13:43:53 -0000 1.207 >> +++ doc/en_US.ISO8859-1/articles/committers-guide/article.sgml 9 Aug 2004 >> 12:21:10 -0000 >> @@ -2431,9 +2431,10 @@ >> >> >> >> - Upgrade the copied port to the new version (remember >> - to change the PORTNAME so there >> - are not duplicate ports with the same name). >> + Upgrade the copied port to the new version. Remember >> + to change either the PORTNAME or >> + the LATEST_LINK variable so there >> + are not duplicate ports with the same name. >> As said before, I would prefer suggesting to change LATEST_LINK only, and PORTNAME only in rare cases. The reader might get the impression that `apache-1.3' and `apache-2.0' have the same name, although they don't. >> Index: doc/en_US.ISO8859-1/books/porters-handbook/book.sgml >> =================================================================== >> RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters- >> handbook/book.sgml,v >> retrieving revision 1.476 >> diff -u -r1.476 book.sgml >> --- doc/en_US.ISO8859-1/books/porters-handbook/book.sgml 9 Aug 2004 11:51: >> 37 -0000 1.476 >> +++ doc/en_US.ISO8859-1/books/porters-handbook/book.sgml 9 Aug 2004 12:29: >> 31 -0000 >> @@ -1071,7 +1071,11 @@ >> Data::Dumper module becomes >> p5-Data-Dumper. If the software in question >> has numbers, hyphens, or underscores in its name, you may >> include >> - them as well (like kinput2). >> + them as well (like kinput2). Make sure that >> + the PORTNAME and >> + PORTVERSION variables contain the name and >> + the version of the port respectively. You should not mix the >> + two. >> Same here. Perhaps `The version number should not be part of PORTNAME (like apache-2.0), except when the original distribution explicitly name it that way (like libxml2-2.6).' -Oliver