Page MenuHomeFreeBSD

D573.id1945.diff
No OneTemporary

D573.id1945.diff

Index: en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -2741,7 +2741,7 @@
<title>Using Python</title>
<para>The Ports Collection supports parallel installation of
- multiple Python versions. Ports must use a
+ multiple Python versions. Ports must use a
correct <command>python</command> interpreter, according to
the user-settable <varname>PYTHON_VERSION</varname>.
Most prominently, this means replacing the path to
@@ -2762,19 +2762,19 @@
<tgroup cols="2">
<tbody>
<row>
- <entry><varname>USE_PYTHON</varname></entry>
- <entry>The port needs Python. Minimal required version
+ <entry><varname>USES=python</varname></entry>
+ <entry>The port needs Python. The minimal required version
can be specified with values such as
- <literal>2.6+</literal>. Version ranges can also be
- specified, by separating two version numbers with a
- dash, for example, <literal>2.6-2.7</literal></entry>
+ <literal>2.7+</literal>. Version ranges can also be
+ specified by separating two version numbers with a
+ dash: <literal>USES=python:3.2-3.3</literal></entry>
</row>
<row>
- <entry><varname>USE_PYDISTUTILS</varname></entry>
- <entry>Use Python distutils for configuring, compiling
- and installing. This is required when the port comes
- with <filename>setup.py</filename>. This overrides
+ <entry><varname>USE_PYTHON=distutils</varname></entry>
+ <entry>Use Python distutils for configuring, compiling,
+ and installing. This is required when the port comes
+ with <filename>setup.py</filename>. This overrides
the <buildtarget>do-build</buildtarget> and
<buildtarget>do-install</buildtarget> targets and may
also override <buildtarget>do-configure</buildtarget>
@@ -2783,10 +2783,26 @@
</row>
<row>
+ <entry><varname>USE_PYTHON=autoplist</varname></entry>
+ <entry>Create the packaging list automatically. This also requires
+ <literal>USE_PYTHON=distutils</literal> to be set.
+ </entry>
+ </row>
+
+ <row>
+ <entry><varname>USE_PYTHON=concurrent</varname></entry>
+ <entry>Marks the port as safe to be installed for different python
+ versions at the same time. The port will use an unique prefix for
+ certain directories, such as <literal>EXAMPLESDIR</literal> and
+ <literal>DOCSDIR</literal> and also will append a suffix to binaries
+ and scripts to be installed.</entry>
+ </row>
+
+ <row>
<entry><varname>PYTHON_PKGNAMEPREFIX</varname></entry>
<entry>Used as a <varname>PKGNAMEPREFIX</varname> to
distinguish packages for different Python versions.
- Example: <literal>py24-</literal></entry>
+ Example: <literal>py27-</literal></entry>
</row>
<row>
@@ -2837,7 +2853,25 @@
</table>
<para>A complete list of available variables can be found in
- <filename>/usr/ports/Mk/bsd.python.mk</filename>.</para>
+ <filename>/usr/ports/Mk/Uses/python.mk</filename>.</para>
+
+
+ <example xml:id="python-Makefile">
+ <title>Makefile for a simple <application>Python</application>
+ Module</title>
+
+ <programlisting>PORTNAME= sample
+PORTVERSION= 1.2.3
+CATEGORIES= devel
+
+MAINTAINER= john@doe.tld
+COMMENT= Python sample module
+
+USES= python
+USE_PYTHON= autoplist distutils
+
+.include &lt;bsd.port.mk&gt;</programlisting>
+ </example>
<para>Some Python applications claim to have
<varname>DESTDIR</varname> support (which would be required
Index: en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -951,6 +951,23 @@
run-time dependency.</entry>
</row>
+ <row xml:id="uses-python">
+ <entry><literal>python</literal></entry>
+ <entry>(none),
+ <literal><replaceable>X.Y</replaceable></literal>,
+ <literal><replaceable>X.Y+</replaceable></literal>,
+ <literal><replaceable>-X.Y</replaceable></literal>,
+ <literal><replaceable>X.Y-Z.A</replaceable></literal>,
+ <literal>build</literal>,
+ <literal>run</literal>
+ </entry>
+ <entry>Uses <application>Python</application>. 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 <literal>build</literal> or
+ <literal>run</literal>.</entry>
+ </row>
+
<row xml:id="uses-qmail">
<entry><literal>qmail</literal></entry>

File Metadata

Mime Type
text/plain
Expires
Thu, Jul 23, 8:11 AM (3 h, 48 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
35396050
Default Alt Text
D573.id1945.diff (4 KB)

Event Timeline