From owner-svn-doc-head@FreeBSD.ORG Tue Oct 28 20:15: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.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 422B5158; Tue, 28 Oct 2014 20:15: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)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 19F51D7; Tue, 28 Oct 2014 20:15:03 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id s9SKF22c049606; Tue, 28 Oct 2014 20:15:02 GMT (envelope-from wblock@FreeBSD.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id s9SKF2tO049602; Tue, 28 Oct 2014 20:15:02 GMT (envelope-from wblock@FreeBSD.org) Message-Id: <201410282015.s9SKF2tO049602@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: wblock set sender to wblock@FreeBSD.org using -f From: Warren Block Date: Tue, 28 Oct 2014 20:15:02 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r45883 - in head/en_US.ISO8859-1/books/porters-handbook: special uses 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.18-1 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, 28 Oct 2014 20:15:03 -0000 Author: wblock Date: Tue Oct 28 20:15:02 2014 New Revision: 45883 URL: https://svnweb.freebsd.org/changeset/doc/45883 Log: Add mva's updates to the Using Python section, with thanks to mat. Differential Revision: https://reviews.freebsd.org/D573 Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Tue Oct 28 12:02:59 2014 (r45882) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Tue Oct 28 20:15:02 2014 (r45883) @@ -2762,19 +2762,19 @@ SOCKETS_USE= PHP=sockets - USE_PYTHON - The port needs Python. Minimal required version + USES=python + The port needs Python. The minimal required version can be specified with values such as - 2.6+. Version ranges can also be - specified, by separating two version numbers with a - dash, for example, 2.6-2.7 + 2.7+. Version ranges can also be + specified by separating two version numbers with a + dash: USES=python:3.2-3.3 - USE_PYDISTUTILS - Use Python distutils for configuring, compiling - and installing. This is required when the port comes - with setup.py. This overrides + USE_PYTHON=distutils + Use Python distutils for configuring, compiling, + and installing. This is required when the port comes + with setup.py. This overrides the do-build and do-install targets and may also override do-configure @@ -2783,10 +2783,29 @@ SOCKETS_USE= PHP=sockets + USE_PYTHON=autoplist + Create the packaging list automatically. This also requires + USE_PYTHON=distutils to be set. + + + + + USE_PYTHON=concurrent + The port will use an unique prefix, typically + PYTHON_PKGNAMEPREFIX for certain directories, such + as EXAMPLESDIR and DOCSDIR and + also will append a suffix, the python version from + PYTHON_VER, to binaries and scripts to be + installed. This allows ports to be installed for different Python + versions at the same time, which otherwise would install conflicting + files. + + + PYTHON_PKGNAMEPREFIX Used as a PKGNAMEPREFIX to distinguish packages for different Python versions. - Example: py24- + Example: py27- @@ -2837,7 +2856,25 @@ SOCKETS_USE= PHP=sockets A complete list of available variables can be found in - /usr/ports/Mk/bsd.python.mk. + /usr/ports/Mk/Uses/python.mk. + + + + Makefile for a Simple <application>Python</application> + Module + + PORTNAME= sample +PORTVERSION= 1.2.3 +CATEGORIES= devel + +MAINTAINER= john@doe.tld +COMMENT= Python sample module + +USES= python +USE_PYTHON= autoplist distutils + +.include <bsd.port.mk> + Some Python applications claim to have DESTDIR support (which would be required Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Tue Oct 28 12:02:59 2014 (r45882) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Tue Oct 28 20:15:02 2014 (r45883) @@ -953,6 +953,24 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa run-time dependency. + + python + (none), + X.Y, + X.Y+, + -X.Y, + X.Y-Z.A, + build, + run + + Uses Python. A supported + version or version range can be specified. If Python is + only needed at build or run time, it can be set as a build + or run dependency with build or + run. See + for more information. + + qmail