diff --git a/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml index 16484cfa12..6fd48ee8ed 100644 --- a/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml +++ b/en_US.ISO8859-1/books/porters-handbook/flavors/chapter.xml @@ -259,161 +259,157 @@ lite_PKGNAMESUFFIX= -lite - - Flavors Auto-Activation + + <literal>USES=php</literal> and Flavors - - <literal>USES=php</literal> and Flavors + When using USES=php with + one of these arguments, phpize, + ext, zend, or + pecl, the port will automatically have + FLAVORS filled in with the + PHP versions it supports. - When using USES=php with - one of these arguments, phpize, - ext, zend, or - pecl, the port will automatically have - FLAVORS filled in with the - PHP versions it supports. + + All the examples assume the currently supported PHP + versions are 5.6, 7.0, 7.1, and 7.2. + - - All the examples assume the currently supported PHP - versions are 5.6, 7.0, 7.1, and 7.2. - + + Simple <literal>USES=php</literal> Extension - - Simple <literal>USES=php</literal> Extension + This will generate package for all the supported + versions: - This will generate package for all the supported - versions: - - PORTNAME= some-ext + PORTNAME= some-ext PORTVERSION= 0.0.1 PKGNAMEPREFIX= ${PHP_PKGNAMEPREFIX} USES= php:ext - This will generate package for all the supported - versions but 7.2: + This will generate package for all the supported + versions but 7.2: - PORTNAME= some-ext + PORTNAME= some-ext PORTVERSION= 0.0.1 PKGNAMEPREFIX= ${PHP_PKGNAMEPREFIX} USES= php:ext IGNORE_WITH_PHP= 72 - + - - PHP Flavors with PHP Applications + + PHP Flavors with PHP Applications - PHP applications can also be flavorized. + PHP applications can also be flavorized. - This allows generating packages for all PHP versions, so - that users can use them with whatever version they need on - their servers. + This allows generating packages for all PHP versions, so + that users can use them with whatever version they need on + their servers. - - PHP applications that are flavorized - must append - PHP_PKGNAMESUFFIX to their package - names. - + + PHP applications that are flavorized + must append + PHP_PKGNAMESUFFIX to their package + names. + - - Flavorizing a PHP Application + + Flavorizing a PHP Application - Adding Flavors support to a PHP application is - straightforward: + Adding Flavors support to a PHP application is + straightforward: - PKGNAMESUFFIX= ${PHP_PKGNAMESUFFIX} + PKGNAMESUFFIX= ${PHP_PKGNAMESUFFIX} USES= php:flavors - - - - - - <literal>USES=python</literal> and Flavors - - When using USES=python - and USE_PYTHON=distutils, the port will - automatically have FLAVORS filled in with - the Python versions it - supports. - - - Simple <literal>USES=python</literal> - - Supposing the current Python - supported versions are 2.7, 3.4, 3.5, and 3.6, and the - default Python 2 and 3 versions - are 2.7 and 3.6, a port with: - - USES= python -USE_PYTHON= distutils - - Will get these flavors: py27, and - py36. - - USES= python -USE_PYTHON= distutils allflavors - - Will get these flavors: py27, - py34, py35 and - py36. - - - - <literal>USES=python</literal> with Version - Requirements - - Supposing the current Python - supported versions are 2.7, 3.4, 3.5, and 3.6, and the - default Python 2 and 3 versions - are 2.7 and 3.6, a port with: - - USES= python:-3.5 -USE_PYTHON= distutils - - Will get this flavor: py27. - - USES= python:-3.5 -USE_PYTHON= distutils allflavors - - Will get these flavors: py27, - py34, and py35. - - USES= python:3.4+ -USE_PYTHON= distutils - - Will get this flavor: py36. - - USES= python:3.4+ -USE_PYTHON= distutils allflavors - - Will get these flavors: py34, - py35, and py36. - - - PY_FLAVOR will be available to depend - on the correct version of Python - modules. This is most useful for ports that are not - Python modules and do not have - Python flavors but do use - python for some part of their - operations. - - - For a Port Not Using - <literal>distutils</literal> - - If the default Python 3 - version is 3.6, the following will set - PY_FLAVOR to - py36: - - RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}mutagen>0:audio/py-mutagen@${PY_FLAVOR} - -USES= python:3.5+ + + + <literal>USES=python</literal> and Flavors + + When using USES=python + and USE_PYTHON=distutils, the port will + automatically have FLAVORS filled in with + the Python versions it + supports. + + + Simple <literal>USES=python</literal> + + Supposing the current Python + supported versions are 2.7, 3.4, 3.5, and 3.6, and the + default Python 2 and 3 versions + are 2.7 and 3.6, a port with: + + USES= python +USE_PYTHON= distutils + + Will get these flavors: py27, and + py36. + + USES= python +USE_PYTHON= distutils allflavors + + Will get these flavors: py27, + py34, py35 and + py36. + + + + <literal>USES=python</literal> with Version + Requirements + + Supposing the current Python + supported versions are 2.7, 3.4, 3.5, and 3.6, and the + default Python 2 and 3 versions + are 2.7 and 3.6, a port with: + + USES= python:-3.5 +USE_PYTHON= distutils + + Will get this flavor: py27. + + USES= python:-3.5 +USE_PYTHON= distutils allflavors + + Will get these flavors: py27, + py34, and py35. + + USES= python:3.4+ +USE_PYTHON= distutils + + Will get this flavor: py36. + + USES= python:3.4+ +USE_PYTHON= distutils allflavors + + Will get these flavors: py34, + py35, and py36. + + + PY_FLAVOR will be available to depend + on the correct version of Python + modules. This is most useful for ports that are not + Python modules and do not have + Python flavors but do use + python for some part of their + operations. + + + For a Port Not Using + <literal>distutils</literal> + + If the default Python 3 + version is 3.6, the following will set + PY_FLAVOR to + py36: + + RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}mutagen>0:audio/py-mutagen@${PY_FLAVOR} + +USES= python:3.5+ + +