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>