Date: Thu, 23 Jul 2015 14:27:37 +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: r47055 - head/en_US.ISO8859-1/books/porters-handbook/uses Message-ID: <201507231427.t6NERbDl087890@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat Date: Thu Jul 23 14:27:36 2015 New Revision: 47055 URL: https://svnweb.freebsd.org/changeset/doc/47055 Log: Convert the USES table into multiple <sect1>. To translators, the only text change are: - The chapter title; - For each argument entry, the text "Possible arguments: " is prepended to the argument list; - The first sect1 is new; The rest of the change is, replace <row> tags with <sect1>, replace the first <entry> of each <row> by a <title>, and the following <entry> by <para>. Approved by: wblock (mentor) MFH: Relnotes: Sponsored by: Absolight Differential Revision: https://reviews.freebsd.org/D3142 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 Thu Jul 23 14:14:11 2015 (r47054) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Thu Jul 23 14:27:36 2015 (r47055) @@ -14,57 +14,82 @@ format is easy to grasp from the already-added entries below (or use this scheme below as a skeleton): -<row xml:id="uses-FEATURE"> - <entry><literal>FEATURE</literal></entry> +<sect1 xml:id="uses-FEATURE"> + <title><literal>FEATURE</literal></title> - <entry>ARGUMENTS</entry> + <para>Possible arguments: ARGUMENTS</para> - <entry>DESCRIPTION</entry> -</row> + <para>DESCRIPTION</para> +</sect1> --> <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink= "http://www.w3.org/1999/xlink" version="5.0" xml:id="uses"> - <title xml:id="uses-values">Values of - <varname>USES</varname></title> + <title xml:id="uses-values">Using <varname>USES</varname> + Macros</title> - <table xml:id="uses-values-table"> - <title>Values of <varname>USES</varname></title> + <sect1 xml:id="uses-intro"> + <title>An Introduction to <varname>USES</varname></title> - <tgroup cols="3"> - <thead> - <row> - <entry>Feature</entry> + <para><varname>USES</varname> macros make it easy to declare + requirements and settings for a port. They can add + dependencies, change building behavior, add metadata to + packages, and so on, all by selecting simple, preset + values..</para> - <entry>Arguments</entry> + <para>Each section in this chapter describes a possible value for + <varname>USES</varname>, along with its possible arguments. + Arguments are appeneded to the value after a colon + (<literal>:</literal>). Multiple arguments are separated by + commas (<literal>,</literal>).</para> - <entry>Description</entry> - </row> - </thead> + <example> + <title>Using Multiple Values</title> - <tbody valign="top"> - <row xml:id="uses-ada"> - <entry><literal>ada</literal></entry> + <programlisting>USES= bison perl</programlisting> + </example> - <entry>(none), <literal>47</literal>, <literal>49</literal>, - <literal>5</literal></entry> + <example> + <title>Adding an Argument</title> - <entry>Depends on an <application>Ada</application>-capable + <programlisting>USES= gmake:lite</programlisting> + </example> + + <example> + <title>Adding Multiple Arguments</title> + + <programlisting>USES= drupal:7,theme</programlisting> + </example> + + <example> + <title>Mixing it All Together</title> + + <programlisting>USES= pgsql:9.3+ cpe python:2.7,build</programlisting> + </example> + </sect1> + + <sect1 xml:id="uses-ada"> + <title><literal>ada</literal></title> + + <para>Possible arguments: (none), <literal>47</literal>, <literal>49</literal>, + <literal>5</literal></para> + + <para>Depends on an <application>Ada</application>-capable compiler, and sets <varname>CC</varname> accordingly. Defaults to a <application>gcc</application> 4.9 based compiler, use <literal>:47</literal> to use the older <application>gcc</application> 4.7 based one and <literal>:5</literal> to use the newer - <application>gcc</application> 5 based one.</entry> - </row> + <application>gcc</application> 5 based one.</para> + </sect1> - <row xml:id="uses-autoreconf"> - <entry><literal>autoreconf</literal></entry> + <sect1 xml:id="uses-autoreconf"> + <title><literal>autoreconf</literal></title> - <entry>(none), <literal>build</literal></entry> + <para>Possible arguments: (none), <literal>build</literal></para> - <entry>Runs <command>autoreconf</command>. It encapsulates + <para>Runs <command>autoreconf</command>. It encapsulates the <command>aclocal</command>, <command>autoconf</command>, <command>autoheader</command>, @@ -80,75 +105,75 @@ <command>autoreconf</command> will recursively update those as well. The <literal>:build</literal> argument only adds build time dependencies on those tools but does - not run <command>autoreconf</command>.</entry> - </row> + not run <command>autoreconf</command>.</para> + </sect1> - <row xml:id="uses-blaslapack"> - <entry><literal>blaslapack</literal></entry> + <sect1 xml:id="uses-blaslapack"> + <title><literal>blaslapack</literal></title> - <entry>(none), <literal>atlas</literal>, + <para>Possible arguments: (none), <literal>atlas</literal>, <literal>netlib</literal> (default), <literal>gotoblas</literal>, - <literal>openblas</literal></entry> + <literal>openblas</literal></para> - <entry>Adds dependencies on Blas / Lapack libraries.</entry> - </row> + <para>Adds dependencies on Blas / Lapack libraries.</para> + </sect1> - <row xml:id="uses-bison"> - <entry><literal>bison</literal></entry> + <sect1 xml:id="uses-bison"> + <title><literal>bison</literal></title> - <entry>(none), <literal>build</literal>, - <literal>run</literal>, <literal>both</literal></entry> + <para>Possible arguments: (none), <literal>build</literal>, + <literal>run</literal>, <literal>both</literal></para> - <entry>Uses <package role="port">devel/bison</package> + <para>Uses <package role="port">devel/bison</package> By default, with no arguments or with the <literal>build</literal> argument, it implies <command>bison</command> is a build-time dependency, <literal>run</literal> implies a run-time dependency, and <literal>both</literal> implies both run-time and - build-time dependencies.</entry> - </row> + build-time dependencies.</para> + </sect1> - <row xml:id="uses-charsetfix"> - <entry><literal>charsetfix</literal></entry> + <sect1 xml:id="uses-charsetfix"> + <title><literal>charsetfix</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Prevents the port from installing + <para>Prevents the port from installing <filename>charset.alias</filename>. This must be installed only by <package role="port">converters/libiconv</package>. <varname>CHARSETFIX_MAKEFILEIN</varname> can be set to a path relative to <varname>WRKSRC</varname> if <filename>charset.alias</filename> is not installed by - <filename>${WRKSRC}/Makefile.in</filename>.</entry> - </row> + <filename>${WRKSRC}/Makefile.in</filename>.</para> + </sect1> - <row xml:id="uses-cmake"> - <entry><literal>cmake</literal></entry> + <sect1 xml:id="uses-cmake"> + <title><literal>cmake</literal></title> - <entry>(none), <literal>outsource</literal>, - <literal>run</literal></entry> + <para>Possible arguments: (none), <literal>outsource</literal>, + <literal>run</literal></para> - <entry>Uses <application>CMake</application> for configuring + <para>Uses <application>CMake</application> for configuring and building. With the <literal>outsource</literal> argument, an out-of-source build will be performed. With the <literal>run</literal> argument, a run-time dependency is registered. For more information see - <xref linkend="using-cmake"/>.</entry> - </row> + <xref linkend="using-cmake"/>.</para> + </sect1> - <row xml:id="uses-compiler"> - <entry><literal>compiler</literal></entry> + <sect1 xml:id="uses-compiler"> + <title><literal>compiler</literal></title> - <entry>(none), <literal>c++0x</literal>, + <para>Possible arguments: (none), <literal>c++0x</literal>, <literal>c++11-lang</literal>, <literal>gcc-c++11-lib</literal>, <literal>c++11-lib</literal>, <literal>c11</literal>, <literal>openmp</literal>, <literal>nestedfct</literal>, - <literal>features</literal></entry> + <literal>features</literal></para> - <entry>Determines which compiler to use based on any given + <para>Determines which compiler to use based on any given wishes. Use <literal>c++11-lang</literal> if the port needs a C++11-capable compiler, <literal>gcc-c++11-lib</literal> if the port needs the @@ -198,15 +223,15 @@ features supported by the default compiler. It currently lists the C++ library.</para> </listitem> - </itemizedlist></entry> - </row> + </itemizedlist></para> + </sect1> - <row xml:id="uses-cpe"> - <entry><literal>cpe</literal></entry> + <sect1 xml:id="uses-cpe"> + <title><literal>cpe</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry> + <para> Include Common Platform Enumeration (<acronym>CPE</acronym>) information in package manifest as a <acronym>CPE</acronym> 2.3 formatted string. See the @@ -218,7 +243,7 @@ <procedure> <step> - <para>Search for the official CPE entry for the + <para>Search for the official CPE para for the software product either by using the NVD's <link xlink:href="http://web.nvd.nist.gov/view/cpe/search"><acronym>CPE</acronym>; search engine</link> or in the <link @@ -233,7 +258,7 @@ <para>Add <literal>cpe</literal> to <varname>USES</varname> and compare the result of <command>make -V CPE_STR</command> to the - <acronym>CPE</acronym> dictionary entry. Continue + <acronym>CPE</acronym> dictionary para. Continue one step at a time until <command>make -V CPE_STR</command> is correct.</para> </step> @@ -288,50 +313,50 @@ <varname>CPE_STR</varname>.</para> </step> </procedure> - </entry> - </row> + </para> + </sect1> - <row xml:id="uses-cran"> - <entry><literal>cran</literal></entry> + <sect1 xml:id="uses-cran"> + <title><literal>cran</literal></title> - <entry>(none), <literal>auto-plist</literal></entry> + <para>Possible arguments: (none), <literal>auto-plist</literal></para> - <entry>Uses the Comprehensive R Archive Network. Specify + <para>Uses the Comprehensive R Archive Network. Specify <varname>auto-plist</varname> to automatically generate - <filename>pkg-plist</filename>.</entry> - </row> + <filename>pkg-plist</filename>.</para> + </sect1> - <row xml:id="uses-desktop-file-utils"> - <entry><literal>desktop-file-utils</literal></entry> + <sect1 xml:id="uses-desktop-file-utils"> + <title><literal>desktop-file-utils</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Uses + <para>Uses <application>update-desktop-database</application> from <package role="port">devel/desktop-file-utils</package>. An extra post-install step will be run without interfering with any post-install steps already in the port <filename>Makefile</filename>. A line with <link linkend="plist-keywords-desktop-file-utils"><literal>@desktop-file-utils</literal></link> - will be added to the plist.</entry> - </row> + will be added to the plist.</para> + </sect1> - <row xml:id="uses-desthack"> - <entry><literal>desthack</literal></entry> + <sect1 xml:id="uses-desthack"> + <title><literal>desthack</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Changes the behavior of GNU configure to properly + <para>Changes the behavior of GNU configure to properly support <varname>DESTDIR</varname> in case the original - software does not.</entry> - </row> + software does not.</para> + </sect1> - <row xml:id="uses-display"> - <entry><literal>display</literal></entry> + <sect1 xml:id="uses-display"> + <title><literal>display</literal></title> - <entry>(none), ARGS</entry> + <para>Possible arguments: (none), ARGS</para> - <entry>Set up a virtual display environment. If the + <para>Set up a virtual display environment. If the environment variable <varname>DISPLAY</varname> is not set, then <application>Xvfb</application> is added as a build dependency, and <varname>CONFIGURE_ENV</varname> is @@ -339,15 +364,15 @@ instance of <application>Xvfb</application>. The <literal>ARGS</literal> parameter defaults to <literal>install</literal> and controls the phase around - which to start and stop the virtual display.</entry> - </row> + which to start and stop the virtual display.</para> + </sect1> - <row xml:id="uses-dos2unix"> - <entry><literal>dos2unix</literal></entry> + <sect1 xml:id="uses-dos2unix"> + <title><literal>dos2unix</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>The port has files with line endings in + <para>The port has files with line endings in <acronym>DOS</acronym> format which need to be converted. Three variables can be set to control which files will be converted. The default is to convert @@ -370,114 +395,114 @@ <para><varname>DOS2UNIX_GLOB</varname>: match file names based on a glob pattern.</para> </listitem> - </itemizedlist></entry> - </row> + </itemizedlist></para> + </sect1> - <row xml:id="uses-drupal"> - <entry><literal>drupal</literal></entry> + <sect1 xml:id="uses-drupal"> + <title><literal>drupal</literal></title> - <entry><literal>6</literal>, <literal>7</literal>, + <para>Possible arguments: <literal>6</literal>, <literal>7</literal>, <literal>module</literal>, - <literal>theme</literal></entry> + <literal>theme</literal></para> - <entry>Automate installation of a port that is a + <para>Automate installation of a port that is a <application>Drupal</application> theme or module. Use with the version of Drupal that the port is expecting. For example, <literal>USES=drupal:6,module</literal> says that this port creates a Drupal 6 module. A Drupal 7 theme can be specified with - <literal>USES=drupal:7,theme</literal>.</entry> - </row> + <literal>USES=drupal:7,theme</literal>.</para> + </sect1> - <row xml:id="uses-execinfo"> - <entry><literal>execinfo</literal></entry> + <sect1 xml:id="uses-execinfo"> + <title><literal>execinfo</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Add a library dependency on <package + <para>Add a library dependency on <package role="port">devel/libexecinfo</package> if <filename>libexecinfo.so</filename> is not present in the - base system.</entry> - </row> + base system.</para> + </sect1> - <row xml:id="uses-fakeroot"> - <entry><literal>fakeroot</literal></entry> + <sect1 xml:id="uses-fakeroot"> + <title><literal>fakeroot</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Changes some default behaviour of build systems to + <para>Changes some default behaviour of build systems to allow installing as a user. See <link xlink:href="http://fakeroot.alioth.debian.org/"/>; for - more information on <command>fakeroot</command>.</entry> - </row> + more information on <command>fakeroot</command>.</para> + </sect1> - <row xml:id="uses-fam"> - <entry><literal>fam</literal></entry> + <sect1 xml:id="uses-fam"> + <title><literal>fam</literal></title> - <entry>(none), fam, gamin</entry> + <para>Possible arguments: (none), fam, gamin</para> - <entry>Uses a File Alteration Monitor as a library + <para>Uses a File Alteration Monitor as a library dependency, either <package role="port">devel/fam</package> or <package role="port">devel/gamin</package>. End users can - set WITH_FAM_SYSTEM to specify their preference.</entry> - </row> + set WITH_FAM_SYSTEM to specify their preference.</para> + </sect1> - <row xml:id="uses-fmake"> - <entry><literal>fmake</literal></entry> + <sect1 xml:id="uses-fmake"> + <title><literal>fmake</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Uses <package role="port">devel/fmake</package> as a - build-time dependency.</entry> - </row> + <para>Uses <package role="port">devel/fmake</package> as a + build-time dependency.</para> + </sect1> - <row xml:id="uses-fonts"> - <entry><literal>fonts</literal></entry> + <sect1 xml:id="uses-fonts"> + <title><literal>fonts</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Adds a runtime dependency on tools needed to register + <para>Adds a runtime dependency on tools needed to register fonts, and add an <literal><link linkend="plist-keywords-fcfontsdir">@fcfontsdir</link> - ${FONTSDIR}</literal> entry to the plist. + ${FONTSDIR}</literal> para to the plist. <varname>FONTSDIR</varname> defaults to <filename>${PREFIX}/lib/X11/fonts/${FONTNAME}</filename> and <varname>FONTNAME</varname> to - <literal>${PORTNAME}</literal>.</entry> - </row> + <literal>${PORTNAME}</literal>.</para> + </sect1> - <row xml:id="uses-fortran"> - <entry><literal>fortran</literal></entry> + <sect1 xml:id="uses-fortran"> + <title><literal>fortran</literal></title> - <entry><literal>gcc</literal> (default), - <literal>ifort</literal></entry> + <para>Possible arguments: <literal>gcc</literal> (default), + <literal>ifort</literal></para> - <entry>Uses the Fortran compiler from either GNU or - Intel.</entry> - </row> + <para>Uses the Fortran compiler from either GNU or + Intel.</para> + </sect1> - <row xml:id="uses-fuse"> - <entry><literal>fuse</literal></entry> + <sect1 xml:id="uses-fuse"> + <title><literal>fuse</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>The port will depend on the FUSE library and handle + <para>The port will depend on the FUSE library and handle the dependency on the kernel module depending on the - version of &os;.</entry> - </row> + version of &os;.</para> + </sect1> - <row xml:id="uses-gecko"> - <entry><literal>gecko</literal></entry> + <sect1 xml:id="uses-gecko"> + <title><literal>gecko</literal></title> - <entry><literal>libxul</literal> (default), + <para>Possible arguments: <literal>libxul</literal> (default), <literal>firefox</literal>, <literal>seamonkey</literal>, <literal>thunderbird</literal>, <literal>build</literal>, <literal><replaceable>XY</replaceable></literal>, - <literal><replaceable>XY</replaceable>+</literal></entry> + <literal><replaceable>XY</replaceable>+</literal></para> - <entry>Add a dependency on different + <para>Add a dependency on different <application>gecko</application> based applications. If <literal>libxul</literal> is used, it is the only argument allowed. When the argument is not @@ -487,59 +512,59 @@ along with optional <literal>build</literal> and <literal><replaceable>XY</replaceable></literal>/<literal><replaceable>XY</replaceable>+</literal> version - arguments.</entry> - </row> + arguments.</para> + </sect1> - <row xml:id="uses-gettext"> - <entry><literal>gettext</literal></entry> + <sect1 xml:id="uses-gettext"> + <title><literal>gettext</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Deprecated. Will include both <link + <para>Deprecated. Will include both <link linkend="uses-gettext-runtime"><literal>gettext-runtime</literal></link> and <link - linkend="uses-gettext-tools"><literal>gettext-tools</literal></link>.</entry> - </row> + linkend="uses-gettext-tools"><literal>gettext-tools</literal></link>.</para> + </sect1> - <row xml:id="uses-gettext-runtime"> - <entry><literal>gettext-runtime</literal></entry> + <sect1 xml:id="uses-gettext-runtime"> + <title><literal>gettext-runtime</literal></title> - <entry>(none), <literal>lib</literal> (default), - <literal>build</literal>, <literal>run</literal></entry> + <para>Possible arguments: (none), <literal>lib</literal> (default), + <literal>build</literal>, <literal>run</literal></para> - <entry>Uses <package + <para>Uses <package role="port">devel/gettext-runtime</package>. By default, with no arguments or with the <literal>lib</literal> argument, implies a library dependency on <filename>libintl.so</filename>. <literal>build</literal> and <literal>run</literal> implies, respectively a build-time and a run-time - dependency on <filename>gettext</filename>.</entry> - </row> + dependency on <filename>gettext</filename>.</para> + </sect1> - <row xml:id="uses-gettext-tools"> - <entry><literal>gettext-tools</literal></entry> + <sect1 xml:id="uses-gettext-tools"> + <title><literal>gettext-tools</literal></title> - <entry>(none), <literal>build</literal> (default), - <literal>run</literal></entry> + <para>Possible arguments: (none), <literal>build</literal> (default), + <literal>run</literal></para> - <entry>Uses <package + <para>Uses <package role="port">devel/gettext-tools</package>. By default, with no argument, or with the <literal>build</literal> argument, a build time dependency on <filename>msgfmt</filename> is registered. With the <literal>run</literal> argument, a run-time dependency is - registered.</entry> - </row> + registered.</para> + </sect1> - <row xml:id="uses-ghostscript"> - <entry><literal>ghostscript</literal></entry> + <sect1 xml:id="uses-ghostscript"> + <title><literal>ghostscript</literal></title> - <entry><replaceable>X</replaceable>, + <para>Possible arguments: <replaceable>X</replaceable>, <literal>build</literal>, <literal>run</literal>, - <literal>nox11</literal></entry> + <literal>nox11</literal></para> - <entry>A specific version + <para>A specific version <replaceable>X</replaceable> can be used. Possible versions are <literal>7</literal>, <literal>8</literal>, <literal>9</literal> (default), and @@ -549,42 +574,41 @@ <literal>build</literal> and <literal>run</literal> add build- and run-time dependencies on <application>Ghostscript</application>. The default is both - build- and run-time dependencies.</entry> - </row> + build- and run-time dependencies.</para> + </sect1> - <row xml:id="uses-gmake"> - <entry><literal>gmake</literal></entry> + <sect1 xml:id="uses-gmake"> + <title><literal>gmake</literal></title> - <entry>(none), <literal>lite</literal></entry> + <para>Possible arguments: (none), <literal>lite</literal></para> - <entry>Uses <package role="port">devel/gmake</package>, or + <para>Uses <package role="port">devel/gmake</package>, or <package role="port">devel/gmake-lite</package> if the <literal>lite</literal> argument is used, as a build-time dependency and sets up the environment to use <command>gmake</command> as the default - <command>make</command> for the build.</entry> - </row> + <command>make</command> for the build.</para> + </sect1> - <row xml:id="uses-gperf"> - <entry><literal>gperf</literal></entry> + <sect1 xml:id="uses-gperf"> + <title><literal>gperf</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Add a buildtime dependency on <package + <para>Add a buildtime dependency on <package role="port">devel/gperf</package> if <command>gperf</command> is not present in the base - system.</entry> - </row> + system.</para> + </sect1> - <row xml:id="uses-gssapi"> - <entry><literal>gssapi</literal></entry> + <sect1 xml:id="uses-gssapi"> + <title><literal>gssapi</literal></title> - <entry>(none), <literal>base</literal> (default), + <para>Possible arguments: (none), <literal>base</literal> (default), <literal>heimdal</literal>, <literal>mit</literal>, <literal>flags</literal>, - <literal>bootstrap</literal></entry> + <literal>bootstrap</literal></para> - <entry> <para>Handle dependencies needed by consumers of the <acronym>GSS-API</acronym>. Only libraries that provide the <application>Kerberos</application> mechanism are @@ -666,31 +690,31 @@ GSSAPI_HEIMDAL_CONFIGURE_ON= --with-gssa GSSAPI_MIT_USES= gssapi:mit GSSAPI_MIT_CONFIGURE_ON= --with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS} GSSAPI_NONE_CONFIGURE_ON= --without-gssapi</programlisting> - </example></entry> - </row> + </example> + </sect1> - <row xml:id="uses-horde"> - <entry><literal>horde</literal></entry> + <sect1 xml:id="uses-horde"> + <title><literal>horde</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Add buildtime and runtime dependencies on <package + <para>Add buildtime and runtime dependencies on <package role="port">devel/pear-channel-horde</package>. Other <application>Horde</application> dependencies can be added with <varname>USE_HORDE_BUILD</varname> and <varname>USE_HORDE_RUN</varname>. See <xref - linkend="php-horde"/> for more information.</entry> - </row> + linkend="php-horde"/> for more information.</para> + </sect1> - <row xml:id="uses-iconv"> - <entry><literal>iconv</literal></entry> + <sect1 xml:id="uses-iconv"> + <title><literal>iconv</literal></title> - <entry>(none), <literal>lib</literal>, + <para>Possible arguments: (none), <literal>lib</literal>, <literal>build</literal>, <literal>patch</literal>, <literal>translit</literal>, - <literal>wchar_t</literal></entry> + <literal>wchar_t</literal></para> - <entry>Uses <command>iconv</command> functions, either from + <para>Uses <command>iconv</command> functions, either from the port <package role="port">converters/libiconv</package> as a build-time and run-time dependency, or from the base @@ -706,17 +730,17 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <literal>//TRANSLIT</literal> iconv extensions, add the relevant arguments so that the correct iconv is used. For more information see - <xref linkend="using-iconv"/>.</entry> - </row> + <xref linkend="using-iconv"/>.</para> + </sect1> - <row xml:id="uses-imake"> - <entry><literal>imake</literal></entry> + <sect1 xml:id="uses-imake"> + <title><literal>imake</literal></title> - <entry>(none), <literal>env</literal>, + <para>Possible arguments: (none), <literal>env</literal>, <literal>notall</literal>, - <literal>noman</literal></entry> + <literal>noman</literal></para> - <entry>Add <package role="port">devel/imake</package> as a + <para>Add <package role="port">devel/imake</package> as a build-time dependency and run <command>xmkmf -a</command> during the <buildtarget>configure</buildtarget> stage. If the <literal>env</literal> argument is given, the @@ -725,16 +749,16 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa add the <literal>notall</literal> argument. If <command>xmkmf</command> does not generate a <buildtarget>install.man</buildtarget> target, add the - <literal>noman</literal> argument.</entry> - </row> + <literal>noman</literal> argument.</para> + </sect1> - <row xml:id="uses-kmod"> - <entry><literal>kmod</literal></entry> + <sect1 xml:id="uses-kmod"> + <title><literal>kmod</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Fills in the boilerplate for kernel module ports, - currently: + <para>Fills in the boilerplate for kernel module ports, + currently:</para> <itemizedlist> <listitem> @@ -771,45 +795,45 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa installation and deinstallation, using <link linkend="plist-keywords-kld"><literal>@kld</literal></link>.</para> </listitem> - </itemizedlist></entry> - </row> + </itemizedlist> + </sect1> - <row xml:id="uses-lha"> - <entry><literal>lha</literal></entry> - <entry>(none)</entry> - <entry>Set <varname>EXTRACT_SUFX</varname> to - <literal>.lzh</literal></entry> - </row> + <sect1 xml:id="uses-lha"> + <title><literal>lha</literal></title> + <para>Possible arguments: (none)</para> + <para>Set <varname>EXTRACT_SUFX</varname> to + <literal>.lzh</literal></para> + </sect1> - <row xml:id="uses-libarchive"> - <entry><literal>libarchive</literal></entry> + <sect1 xml:id="uses-libarchive"> + <title><literal>libarchive</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Registers a dependency on <package + <para>Registers a dependency on <package role="port">archivers/libarchive</package>. Any ports depending on <application>libarchive</application> must - include <literal>USES=libarchive</literal>.</entry> - </row> + include <literal>USES=libarchive</literal>.</para> + </sect1> - <row xml:id="uses-libedit"> - <entry><literal>libedit</literal></entry> + <sect1 xml:id="uses-libedit"> + <title><literal>libedit</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Registers a dependency on <package + <para>Registers a dependency on <package role="port">devel/libedit</package>. Any ports depending on <application>libedit</application> must - include <literal>USES=libedit</literal>.</entry> - </row> + include <literal>USES=libedit</literal>.</para> + </sect1> - <row xml:id="uses-libtool"> - <entry><literal>libtool</literal></entry> + <sect1 xml:id="uses-libtool"> + <title><literal>libtool</literal></title> - <entry>(none), <literal>keepla</literal>, - <literal>build</literal></entry> + <para>Possible arguments: (none), <literal>keepla</literal>, + <literal>build</literal></para> - <entry>Patches <command>libtool</command> scripts. This + <para>Patches <command>libtool</command> scripts. This must be added to all ports that use <command>libtool</command>. The <literal>keepla</literal> argument can be used to keep <filename>.la</filename> @@ -817,175 +841,175 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa libtool and need a build time dependency on <package role="port">devel/libtool</package>, use the <literal>:build</literal> argument to add such - dependency.</entry> - </row> + dependency.</para> + </sect1> - <row xml:id="uses-localbase"> - <entry><literal>localbase</literal></entry> + <sect1 xml:id="uses-localbase"> + <title><literal>localbase</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Ensures that libraries from dependencies in + <para>Ensures that libraries from dependencies in <varname>LOCALBASE</varname> are used instead of the ones from the base system. Ports that depend on libraries that are also present in the base system should use this. It is also used internally by a few other - <varname>USES</varname>.</entry> - </row> + <varname>USES</varname>.</para> + </sect1> - <row xml:id="uses-lua"> - <entry><literal>lua</literal></entry> + <sect1 xml:id="uses-lua"> + <title><literal>lua</literal></title> - <entry>(none), + <para>Possible arguments: (none), <literal><replaceable>XY</replaceable>+</literal>, <literal><replaceable>XY</replaceable></literal>, <literal>build</literal>, - <literal>run</literal></entry> + <literal>run</literal></para> - <entry>Adds a dependency on <application>Lua</application>. + <para>Adds a dependency on <application>Lua</application>. By default this is a library dependency, unless overridden by the <literal>build</literal> or <literal>run</literal> option. The default version is 5.2, unless set by the <literal><replaceable>XY</replaceable></literal> parameter (for example, <literal>51</literal> or - <literal>52+</literal>).</entry> - </row> + <literal>52+</literal>).</para> + </sect1> - <row xml:id="uses-makeinfo"> - <entry><literal>makeinfo</literal></entry> + <sect1 xml:id="uses-makeinfo"> + <title><literal>makeinfo</literal></title> - <entry><literal>build</literal> (default), - <literal>run</literal>, <literal>both</literal></entry> + <para>Possible arguments: <literal>build</literal> (default), + <literal>run</literal>, <literal>both</literal></para> - <entry>Add the corresponding dependencies on - <command>makeinfo</command>.</entry> - </row> + <para>Add the corresponding dependencies on + <command>makeinfo</command>.</para> + </sect1> - <row xml:id="uses-makeself"> - <entry><literal>makeself</literal></entry> + <sect1 xml:id="uses-makeself"> + <title><literal>makeself</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Indicates that the distribution files are makeself - archives and sets the appropriate dependencies.</entry> - </row> + <para>Indicates that the distribution files are makeself + archives and sets the appropriate dependencies.</para> + </sect1> - <row xml:id="uses-metaport"> - <entry><literal>metaport</literal></entry> + <sect1 xml:id="uses-metaport"> + <title><literal>metaport</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Sets the following variables to make it easier to + <para>Sets the following variables to make it easier to create a metaport: <varname>MASTER_SITES</varname>, <varname>DISTFILES</varname>, <varname>EXTRACT_ONLY</varname>, <varname>NO_BUILD</varname>, <varname>NO_INSTALL</varname>, <varname>NO_MTREE</varname>, <varname>NO_ARCH</varname>. - </entry> - </row> + </para> + </sect1> - <row xml:id="uses-mono"> - <entry><literal>mono</literal></entry> + <sect1 xml:id="uses-mono"> + <title><literal>mono</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Adds a dependency on the + <para>Adds a dependency on the <application>Mono</application> (currently only C#) - framework by setting the appropriate dependencies.</entry> - </row> + framework by setting the appropriate dependencies.</para> + </sect1> - <row xml:id="uses-motif"> - <entry><literal>motif</literal></entry> + <sect1 xml:id="uses-motif"> + <title><literal>motif</literal></title> - <entry>(none)</entry> + <para>Possible arguments: (none)</para> - <entry>Uses + <para>Uses <package role="port">x11-toolkits/open-motif</package> as a library dependency. End users can set <varname>WANT_LESSTIF</varname> for the dependency to be on <package role="port">x11-toolkits/lesstif</package> instead of <package - role="port">x11-toolkits/open-motif</package>.</entry> - </row> + role="port">x11-toolkits/open-motif</package>.</para> + </sect1> - <row xml:id="uses-ncurses"> - <entry><literal>ncurses</literal></entry> + <sect1 xml:id="uses-ncurses"> + <title><literal>ncurses</literal></title> - <entry>(none), <literal>base</literal>, - <literal>port</literal></entry> + <para>Possible arguments: (none), <literal>base</literal>, + <literal>port</literal></para> - <entry>Uses <application>ncurses</application>, and causes - some useful variables to be set.</entry> *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201507231427.t6NERbDl087890>