svn commit: r50928 - head/en_US.ISO8859-1/books/porters-handbook/uses

[Mathieu Arnold]

Author: mat
Date: Tue Sep 26 09:45:40 2017
New Revision: 50928
URL: https://svnweb.freebsd.org/changeset/doc/50928

Log:
  Add a couple of tips about PYTHON_NO_DEPENDS.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Sep 26 09:30:53 2017	(r50927)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Sep 26 09:45:40 2017	(r50928)
@@ -2483,6 +2483,14 @@ USE_PYQT=	core doc_build designer_run</programlisting>
       run or test dependency with <literal>build</literal>,
       <literal>run</literal>, or <literal>test</literal>.  See
       <xref linkend="using-python"/> for more information.</para>
+
+    <para><literal>PYTHON_NO_DEPENDS=yes</literal> can be used when
+      the variables exported by the framework are needed but a
+      dependency on <application>Python</application> is not.  It can
+      happen when using with <link
+	linkend="uses-shebangfix"><literal>USES=shebangfix</literal></link>,
+      and the goal is only to fix the shebangs but not add a
+      dependency on <application>Python</application>.</para>
   </sect1>
 
   <sect1 xml:id="uses-qmail">
@@ -2717,6 +2725,14 @@ USE_PYQT=	core doc_build designer_run</programlisting>
 	are available in
 	<literal><replaceable>interp</replaceable>_CMD</literal>.</para>
     </important>
+
+    <tip>
+      <para>When used with <link
+	  linkend="uses-python"><literal>USES=python</literal></link>,
+	and the aim is only to fix the shebangs but a dependency on
+	<application>Python</application> itself is not wanted, use
+	<literal>PYTHON_NO_DEPENDS=yes</literal>.</para>
+    </tip>
 
     <example xml:id="uses-shebangfix-ex-lua">
       <title>Adding Another Interpreter to