From owner-freebsd-doc@FreeBSD.ORG Wed Aug 3 11:50:25 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org 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 4032C16A41F for ; Wed, 3 Aug 2005 11:50:25 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id F2AFA43D58 for ; Wed, 3 Aug 2005 11:50:24 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j73BoOsQ099589 for ; Wed, 3 Aug 2005 11:50:24 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j73BoOCT099588; Wed, 3 Aug 2005 11:50:24 GMT (envelope-from gnats) Date: Wed, 3 Aug 2005 11:50:24 GMT Message-Id: <200508031150.j73BoOCT099588@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Vsevolod Stakhov Cc: Subject: Re: docs/84509: Update some items at porters handbook about Python and PORTDOCS X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Vsevolod Stakhov List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 03 Aug 2005 11:50:25 -0000 The following reply was made to PR docs/84509; it has been noted by GNATS. From: Vsevolod Stakhov To: Giorgos Keramidas Cc: Vsevolod Stakhov , bug-followup@freebsd.org Subject: Re: docs/84509: Update some items at porters handbook about Python and PORTDOCS Date: Wed, 3 Aug 2005 15:49:04 +0400 On Wed, Aug 03, 2005 at 02:09:16PM +0300, Giorgos Keramidas wrote: > On 2005-08-03 13:41, Vsevolod Stakhov wrote: > > The port needs Python. Minimal required version can be > > - specified with values such as 2.3+. > > + specified with values such as 2.3+. > > + Also versions range can be specified: 2.1-2.3 > > > > No, please. The syntax of the new sentence is horrible. Perhaps > something like this would be ok: Ok, thanks a lot, I've prepared modified version of this patch. Sorry, I'll try to improve my English grammar and style. Index: book.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.596 diff -u -r1.596 book.sgml --- book.sgml 25 Jul 2005 13:31:09 -0000 1.596 +++ book.sgml 3 Aug 2005 11:46:21 -0000 @@ -5071,7 +5071,9 @@ USE_PYTHON The port needs Python. Minimal required version can be - specified with values such as 2.3+. + specified with values such as 2.3+. + Version ranges can also be specified, by separating two version + numbers with a dash, e.g.: 2.1-2.3 @@ -5079,7 +5081,11 @@ Use Python distutils for configuring, compiling and installing. This is required when the port comes with - setup.py. + setup.py. This overrides the + do-build and + do-install targets + and may also override do-configure if + GNU_CONFIGURE is not defined. @@ -5093,23 +5099,41 @@ PYTHON_SITELIBDIR - Location of the site-packages tree. Useful when installing - Python modules. Always use + Location of the site-packages tree, that contains + installation path of Python (usually LOCALBASE). + The PYTHON_SITELIBDIR variable can be very + useful when installing Python modules. + + + + PYTHONPREFIX_SITELIBDIR + + The PREFIX-clean variant of PYTHON_SITELIBDIR. + Always use %%PYTHON_SITELIBDIR%% in - pkg-plist when possible. Default value: - lib/python2.4/site-packages + pkg-plist when possible. The default value of + %%PYTHON_SITELIBDIR%% is + lib/python%%PYTHON_VERSION%%/site-packages + + + + PYTHON_CMD + + Python interpreter command line, including version + number. PYNUMERIC - Add dependency on numeric extension. + Dependency line for numeric extension. PYXML - Add dependency on XML extension. + Dependency line for XML extension (not needed for + Python 2.0 and higher as it is also in base distribution). @@ -8711,16 +8735,16 @@ If a directory is listed in PORTDOCS or matched by a glob pattern from this variable, the entire subtree of contained files and directories will be - registered in the final packing list. PORTDOCS - should not be set if NOPORTDOCS is in - effect. Installing the documentation at PORTDOCS + registered in the final packing list. If NOPORTDOCS + is defined then files and directories listed in + PORTDOCS would not be installed and neither + would be added to port packing list. + Installing the documentation at PORTDOCS as shown above remains up to the port itself. A typical example of utilizing PORTDOCS looks as follows: - .if !defined(NOPORTDOCS) - PORTDOCS= * -.endif + PORTDOCS= README.* ChangeLog docs/* You can also use the pkg-message file to