Date: Mon, 30 Apr 2018 15:12:55 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51602 - head/en_US.ISO8859-1/books/porters-handbook/flavors Message-ID: <201804301512.w3UFCtHR051541@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat Date: Mon Apr 30 15:12:54 2018 New Revision: 51602 URL: https://svnweb.freebsd.org/changeset/doc/51602 Log: Flatten the Flavor chapter by removing the encapsulating "Flavors Auto-Activation" section and moving php and Python one setup up. The only change here is sect2 → sect1 and sect3 → sect2. Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml Sat Apr 28 12:59:18 2018 (r51601) +++ head/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml Mon Apr 30 15:12:54 2018 (r51602) @@ -259,161 +259,157 @@ lite_PKGNAMESUFFIX= -lite</programlisting> </sect2> </sect1> - <sect1 xml:id="flavors-auto"> - <title>Flavors Auto-Activation</title> + <sect1 xml:id="flavors-auto-php"> + <title><literal>USES=php</literal> and Flavors</title> - <sect2 xml:id="flavors-auto-php"> - <title><literal>USES=php</literal> and Flavors</title> + <para>When using <link linkend="uses-php">USES=php</link> with + one of these arguments, <literal>phpize</literal>, + <literal>ext</literal>, <literal>zend</literal>, or + <literal>pecl</literal>, the port will automatically have + <varname>FLAVORS</varname> filled in with the + <application>PHP</application> versions it supports.</para> - <para>When using <link linkend="uses-php">USES=php</link> with - one of these arguments, <literal>phpize</literal>, - <literal>ext</literal>, <literal>zend</literal>, or - <literal>pecl</literal>, the port will automatically have - <varname>FLAVORS</varname> filled in with the - <application>PHP</application> versions it supports.</para> + <note> + <para>All the examples assume the currently supported PHP + versions are 5.6, 7.0, 7.1, and 7.2.</para> + </note> - <note> - <para>All the examples assume the currently supported PHP - versions are 5.6, 7.0, 7.1, and 7.2.</para> - </note> + <example xml:id="flavors-auto-php-ex1"> + <title>Simple <literal>USES=php</literal> Extension</title> - <example xml:id="flavors-auto-php-ex1"> - <title>Simple <literal>USES=php</literal> Extension</title> + <para>This will generate package for all the supported + versions:</para> - <para>This will generate package for all the supported - versions:</para> - - <programlisting>PORTNAME= some-ext + <programlisting>PORTNAME= some-ext PORTVERSION= 0.0.1 PKGNAMEPREFIX= ${PHP_PKGNAMEPREFIX} USES= php:ext</programlisting> - <para>This will generate package for all the supported - versions but 7.2:</para> + <para>This will generate package for all the supported + versions but 7.2:</para> - <programlisting>PORTNAME= some-ext + <programlisting>PORTNAME= some-ext PORTVERSION= 0.0.1 PKGNAMEPREFIX= ${PHP_PKGNAMEPREFIX} USES= php:ext IGNORE_WITH_PHP= 72</programlisting> - </example> + </example> - <sect3 xml:id="flavors-auto-php-app"> - <title>PHP Flavors with PHP Applications</title> + <sect2 xml:id="flavors-auto-php-app"> + <title>PHP Flavors with PHP Applications</title> - <para>PHP applications can also be flavorized.</para> + <para>PHP applications can also be flavorized.</para> - <para>This allows generating packages for all PHP versions, so - that users can use them with whatever version they need on - their servers.</para> + <para>This allows generating packages for all PHP versions, so + that users can use them with whatever version they need on + their servers.</para> - <important> - <para>PHP applications that are flavorized - <emphasis>must</emphasis> append - <varname>PHP_PKGNAMESUFFIX</varname> to their package - names.</para> - </important> + <important> + <para>PHP applications that are flavorized + <emphasis>must</emphasis> append + <varname>PHP_PKGNAMESUFFIX</varname> to their package + names.</para> + </important> - <example xml:id="flavors-auto-php-app-ex1"> - <title>Flavorizing a PHP Application</title> + <example xml:id="flavors-auto-php-app-ex1"> + <title>Flavorizing a PHP Application</title> - <para>Adding Flavors support to a PHP application is - straightforward:</para> + <para>Adding Flavors support to a PHP application is + straightforward:</para> - <programlisting>PKGNAMESUFFIX= ${PHP_PKGNAMESUFFIX} + <programlisting>PKGNAMESUFFIX= ${PHP_PKGNAMESUFFIX} USES= php:flavors</programlisting> - </example> - </sect3> + </example> </sect2> + </sect1> - <sect2 xml:id="flavors-auto-python"> - <title><literal>USES=python</literal> and Flavors</title> + <sect1 xml:id="flavors-auto-python"> + <title><literal>USES=python</literal> and Flavors</title> - <para>When using <link - linkend="uses-python"><literal>USES=python</literal></link> - and <literal>USE_PYTHON=distutils</literal>, the port will - automatically have <varname>FLAVORS</varname> filled in with - the <application>Python</application> versions it - supports.</para> + <para>When using <link + linkend="uses-python"><literal>USES=python</literal></link> + and <literal>USE_PYTHON=distutils</literal>, the port will + automatically have <varname>FLAVORS</varname> filled in with + the <application>Python</application> versions it + supports.</para> - <example xml:id="flavors-auto-python-ex1"> - <title>Simple <literal>USES=python</literal></title> + <example xml:id="flavors-auto-python-ex1"> + <title>Simple <literal>USES=python</literal></title> - <para>Supposing the current <application>Python</application> - supported versions are 2.7, 3.4, 3.5, and 3.6, and the - default <application>Python</application> 2 and 3 versions - are 2.7 and 3.6, a port with:</para> + <para>Supposing the current <application>Python</application> + supported versions are 2.7, 3.4, 3.5, and 3.6, and the + default <application>Python</application> 2 and 3 versions + are 2.7 and 3.6, a port with:</para> - <programlisting>USES= python + <programlisting>USES= python USE_PYTHON= distutils</programlisting> - <para>Will get these flavors: <literal>py27</literal>, and - <literal>py36</literal>.</para> + <para>Will get these flavors: <literal>py27</literal>, and + <literal>py36</literal>.</para> - <programlisting>USES= python + <programlisting>USES= python USE_PYTHON= distutils allflavors</programlisting> - <para>Will get these flavors: <literal>py27</literal>, - <literal>py34</literal>, <literal>py35</literal> and - <literal>py36</literal>.</para> - </example> + <para>Will get these flavors: <literal>py27</literal>, + <literal>py34</literal>, <literal>py35</literal> and + <literal>py36</literal>.</para> + </example> - <example xml:id="flavors-auto-python-ex2"> - <title><literal>USES=python</literal> with Version - Requirements</title> + <example xml:id="flavors-auto-python-ex2"> + <title><literal>USES=python</literal> with Version + Requirements</title> - <para>Supposing the current <application>Python</application> - supported versions are 2.7, 3.4, 3.5, and 3.6, and the - default <application>Python</application> 2 and 3 versions - are 2.7 and 3.6, a port with:</para> + <para>Supposing the current <application>Python</application> + supported versions are 2.7, 3.4, 3.5, and 3.6, and the + default <application>Python</application> 2 and 3 versions + are 2.7 and 3.6, a port with:</para> - <programlisting>USES= python:-3.5 + <programlisting>USES= python:-3.5 USE_PYTHON= distutils</programlisting> - <para>Will get this flavor: <literal>py27</literal>.</para> + <para>Will get this flavor: <literal>py27</literal>.</para> - <programlisting>USES= python:-3.5 + <programlisting>USES= python:-3.5 USE_PYTHON= distutils allflavors</programlisting> - <para>Will get these flavors: <literal>py27</literal>, - <literal>py34</literal>, and <literal>py35</literal>.</para> + <para>Will get these flavors: <literal>py27</literal>, + <literal>py34</literal>, and <literal>py35</literal>.</para> - <programlisting>USES= python:3.4+ + <programlisting>USES= python:3.4+ USE_PYTHON= distutils</programlisting> - <para>Will get this flavor: <literal>py36</literal>.</para> + <para>Will get this flavor: <literal>py36</literal>.</para> - <programlisting>USES= python:3.4+ + <programlisting>USES= python:3.4+ USE_PYTHON= distutils allflavors</programlisting> - <para>Will get these flavors: <literal>py34</literal>, - <literal>py35</literal>, and <literal>py36</literal>.</para> - </example> + <para>Will get these flavors: <literal>py34</literal>, + <literal>py35</literal>, and <literal>py36</literal>.</para> + </example> - <para><varname>PY_FLAVOR</varname> will be available to depend - on the correct version of <application>Python</application> - modules. This is most useful for ports that are not - <application>Python</application> modules and do not have - <application>Python</application> flavors but do use - <command>python</command> for some part of their - operations.</para> + <para><varname>PY_FLAVOR</varname> will be available to depend + on the correct version of <application>Python</application> + modules. This is most useful for ports that are not + <application>Python</application> modules and do not have + <application>Python</application> flavors but do use + <command>python</command> for some part of their + operations.</para> - <example xml:id="flavors-auto-python-ex3"> - <title>For a Port Not Using - <literal>distutils</literal></title> + <example xml:id="flavors-auto-python-ex3"> + <title>For a Port Not Using + <literal>distutils</literal></title> - <para>If the default <application>Python</application> 3 - version is 3.6, the following will set - <varname>PY_FLAVOR</varname> to - <literal>py36</literal>:</para> + <para>If the default <application>Python</application> 3 + version is 3.6, the following will set + <varname>PY_FLAVOR</varname> to + <literal>py36</literal>:</para> - <programlisting>RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}mutagen>0:audio/py-mutagen@${PY_FLAVOR} + <programlisting>RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}mutagen>0:audio/py-mutagen@${PY_FLAVOR} USES= python:3.5+</programlisting> - </example> - </sect2> + </example> </sect1> </chapter>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201804301512.w3UFCtHR051541>