From owner-freebsd-doc@FreeBSD.ORG Wed Aug 3 09:50:18 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 0B73016A41F for ; Wed, 3 Aug 2005 09:50:18 +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 C61B643D48 for ; Wed, 3 Aug 2005 09:50:16 +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 j739oG0O085281 for ; Wed, 3 Aug 2005 09:50:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j739oGBt085279; Wed, 3 Aug 2005 09:50:16 GMT (envelope-from gnats) Resent-Date: Wed, 3 Aug 2005 09:50:16 GMT Resent-Message-Id: <200508030950.j739oGBt085279@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Vsevolod Stakhov Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0C4EE16A41F for ; Wed, 3 Aug 2005 09:41:33 +0000 (GMT) (envelope-from vsevolod@highsecure.ru) Received: from waterwall.inec.ru (waterwall.inec.ru [213.148.3.225]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6FFA243D53 for ; Wed, 3 Aug 2005 09:41:31 +0000 (GMT) (envelope-from vsevolod@highsecure.ru) Received: from waterwall.inec.ru (root@localhost) by waterwall.inec.ru (8.13.1/8.12.6) with SMTP id j739h9Lg057516 for ; Wed, 3 Aug 2005 13:43:09 +0400 (MSD) Received: from core (postbox.inec.ru [213.148.3.226]) by waterwall.inec.ru (8.13.1/8.12.6) with ESMTP id j739h8Jn057511 for ; Wed, 3 Aug 2005 13:43:08 +0400 (MSD) Received: from [213.219.249.64] (helo=spray.anyhost.ru) by core with esmtp (Exim 4.51 (FreeBSD)) id 1E0FkB-00002F-0X for FreeBSD-gnats-submit@freebsd.org; Wed, 03 Aug 2005 13:40:59 +0400 Received: from cebka by spray.anyhost.ru with local (Exim 4.52 (FreeBSD)) id 1E0Fkf-000GgJ-Le for FreeBSD-gnats-submit@freebsd.org; Wed, 03 Aug 2005 13:41:29 +0400 Message-Id: Date: Wed, 03 Aug 2005 13:41:29 +0400 From: Vsevolod Stakhov Sender: Vsevolod Stakhov To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: 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 09:50:18 -0000 >Number: 84509 >Category: docs >Synopsis: Update some items at porters handbook about Python and PORTDOCS >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Wed Aug 03 09:50:16 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Vsevolod Stakhov >Release: FreeBSD 5.4-RELEASE i386 >Organization: >Environment: >Description: Some variables of bsd.python.mk can be described more than it is now. Also PORTDOCS variable can be defined even if NOPORTDOCS defined - files from PORTDOCS would just not be installed in that case. Python related changes were reviewed by pav@. >How-To-Repeat: >Fix: 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 07:41:37 -0000 @@ -5071,7 +5071,8 @@ 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+. + Also versions range can be specified: 2.1-2.3 @@ -5079,7 +5080,9 @@ Use Python distutils for configuring, compiling and installing. This is required when the port comes with - setup.py. + setup.py. This override targets: + do-configure (if GNU_CONFIGURE is not + defined), do-build and do-install. @@ -5093,23 +5096,38 @@ PYTHON_SITELIBDIR - Location of the site-packages tree. Useful when installing - Python modules. Always use + Location of the site-packages tree relative to python + installation path (ussually LOCALBASE). + Useful when installing Python modules. + + + + PYTHONPREFIX_SITELIBDIR + Location of the site-packages tree relative to + PREFIX. + Always use %%PYTHON_SITELIBDIR%% in pkg-plist when possible. Default value: - lib/python2.4/site-packages + 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 +8729,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 >Release-Note: >Audit-Trail: >Unformatted: