Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F148154095
D3142.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
53 KB
Referenced Files
None
Subscribers
None
D3142.diff
View Options
Index: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -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_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 @@
<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 @@
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 @@
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 @@
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>
- </row>
+ <para>Uses <application>ncurses</application>, and causes
+ some useful variables to be set.</para>
+ </sect1>
- <row xml:id="uses-ninja">
- <entry><literal>ninja</literal></entry>
+ <sect1 xml:id="uses-ninja">
+ <title><literal>ninja</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Uses <application>ninja</application> to build the
+ <para>Uses <application>ninja</application> to build the
port. End users can set <varname>NINJA_VERBOSE</varname>
- for verbose output.</entry>
- </row>
+ for verbose output.</para>
+ </sect1>
- <row xml:id="uses-objc">
- <entry><literal>objc</literal></entry>
+ <sect1 xml:id="uses-objc">
+ <title><literal>objc</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Add objective C dependencies (compiler, runtime
- library) if the base system does not support it.</entry>
- </row>
+ <para>Add objective C dependencies (compiler, runtime
+ library) if the base system does not support it.</para>
+ </sect1>
- <row xml:id="uses-openal">
- <entry><literal>openal</literal></entry>
+ <sect1 xml:id="uses-openal">
+ <title><literal>openal</literal></title>
- <entry><literal>al</literal>, <literal>soft</literal>
+ <para>Possible arguments: <literal>al</literal>, <literal>soft</literal>
(default), <literal>si</literal>,
- <literal>alut</literal></entry>
+ <literal>alut</literal></para>
- <entry>Uses <application>OpenAL</application>. The backend
+ <para>Uses <application>OpenAL</application>. The backend
can be specified, with the software implementation as the
default. The user can specify a preferred backend with
<varname>WANT_OPENAL</varname>. Valid values for
this knob are <literal>soft</literal> (default) and
- <literal>si</literal>.</entry>
- </row>
+ <literal>si</literal>.</para>
+ </sect1>
- <row xml:id="uses-pathfix">
- <entry><literal>pathfix</literal></entry>
+ <sect1 xml:id="uses-pathfix">
+ <title><literal>pathfix</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Look for <filename>Makefile.in</filename> and
+ <para>Look for <filename>Makefile.in</filename> and
<filename>configure</filename> in the port's
associated sources and fix common paths to make sure they
respect the &os; hierarchy. If the port uses
<command>automake</command>, set
<varname>PATHFIX_MAKEFILEIN</varname> to
- <filename>Makefile.am</filename> if needed.</entry>
- </row>
+ <filename>Makefile.am</filename> if needed.</para>
+ </sect1>
- <row xml:id="uses-pear">
- <entry><literal>pear</literal></entry>
+ <sect1 xml:id="uses-pear">
+ <title><literal>pear</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Adds a dependency on <package
+ <para>Adds a dependency on <package
role="port">devel/pear</package>. It will setup default
behavior for software using the
<application>PHP</application> Extension and Application
Repository. See <xref linkend="php-pear"/> for more
- information.</entry>
- </row>
+ information.</para>
+ </sect1>
- <row xml:id="uses-perl5">
- <entry><literal>perl5</literal></entry>
+ <sect1 xml:id="uses-perl5">
+ <title><literal>perl5</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Depends on <application>Perl</application>. These
+ <para>Depends on <application>Perl</application>. These
variables can be set:
<itemizedlist>
@@ -1030,18 +1054,17 @@
<filename>Build.PL</filename> is required. It
defaults to <literal>build run</literal>.</para>
</listitem>
- </itemizedlist></entry>
- </row>
+ </itemizedlist></para>
+ </sect1>
- <row xml:id="uses-pgsql">
- <entry><literal>pgsql</literal></entry>
+ <sect1 xml:id="uses-pgsql">
+ <title><literal>pgsql</literal></title>
- <entry>(none),
+ <para>Possible arguments: (none),
<literal><replaceable>X.Y</replaceable></literal>,
<literal><replaceable>X.Y</replaceable>+</literal>,
- <literal><replaceable>X.Y</replaceable>-</literal></entry>
+ <literal><replaceable>X.Y</replaceable>-</literal></para>
- <entry>
<para>Provide support for PostgreSQL. Maintainer can
set version required. Minimum and maximum versions can
be specified; for example, 9.0-, 8.4+.</para>
@@ -1051,124 +1074,123 @@
<literal>WANT_PGSQL=server:configure pltcl
plperl</literal> For the full list use
<command>make -V _USE_PGSQL_DEP</command>.</para>
- </entry>
- </row>
+ </sect1>
- <row xml:id="uses-pkgconfig">
- <entry><literal>pkgconfig</literal></entry>
+ <sect1 xml:id="uses-pkgconfig">
+ <title><literal>pkgconfig</literal></title>
- <entry>(none), <literal>build</literal> (default),
- <literal>run</literal>, <literal>both</literal></entry>
+ <para>Possible arguments: (none), <literal>build</literal> (default),
+ <literal>run</literal>, <literal>both</literal></para>
- <entry>Uses <package role="port">devel/pkgconf</package>.
+ <para>Uses <package role="port">devel/pkgconf</package>.
With no arguments or with the <literal>build</literal>
argument, it implies <command>pkg-config</command> as 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>
+ both run-time and build-time dependencies.</para>
+ </sect1>
- <row xml:id="uses-pure">
- <entry><literal>pure</literal></entry>
+ <sect1 xml:id="uses-pure">
+ <title><literal>pure</literal></title>
- <entry>(none), <literal>ffi</literal></entry>
+ <para>Possible arguments: (none), <literal>ffi</literal></para>
- <entry>Uses <package role="port">lang/pure</package>.
+ <para>Uses <package role="port">lang/pure</package>.
Largely used for building related
<application>pure</application> ports. With the
<literal>ffi</literal> argument, it implies
<package role="port">devel/pure-ffi</package> as a
- run-time dependency.</entry>
- </row>
+ run-time dependency.</para>
+ </sect1>
- <row xml:id="uses-python">
- <entry><literal>python</literal></entry>
- <entry>(none),
+ <sect1 xml:id="uses-python">
+ <title><literal>python</literal></title>
+ <para>Possible arguments: (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
+ </para>
+ <para>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>. See <xref linkend="using-python"/>
- for more information.</entry>
- </row>
+ for more information.</para>
+ </sect1>
- <row xml:id="uses-qmail">
- <entry><literal>qmail</literal></entry>
+ <sect1 xml:id="uses-qmail">
+ <title><literal>qmail</literal></title>
- <entry>(none), <literal>build</literal>,
+ <para>Possible arguments: (none), <literal>build</literal>,
<literal>run</literal>,
- <literal>both</literal>, <literal>vars</literal></entry>
+ <literal>both</literal>, <literal>vars</literal></para>
- <entry>Uses <package role="port">mail/qmail</package>. With
+ <para>Uses <package role="port">mail/qmail</package>. With
the <literal>build</literal> argument, it implies
<command>qmail</command> as a build-time dependency.
<literal>run</literal> implies a run-time dependency.
Using no argument or the <literal>both</literal> argument
implies both run-time and build-time dependencies.
<literal>vars</literal> will only set QMAIL variables for
- the port to use.</entry>
- </row>
+ the port to use.</para>
+ </sect1>
- <row xml:id="uses-qmake">
- <entry><literal>qmake</literal></entry>
+ <sect1 xml:id="uses-qmake">
+ <title><literal>qmake</literal></title>
- <entry>(none), <literal>norecursive</literal>,
- <literal>outsource</literal></entry>
+ <para>Possible arguments: (none), <literal>norecursive</literal>,
+ <literal>outsource</literal></para>
- <entry>Uses <application>QMake</application> for
+ <para>Uses <application>QMake</application> for
configuring. For more information see
- <xref linkend="using-qmake"/>.</entry>
- </row>
+ <xref linkend="using-qmake"/>.</para>
+ </sect1>
- <row xml:id="uses-readline">
- <entry><literal>readline</literal></entry>
+ <sect1 xml:id="uses-readline">
+ <title><literal>readline</literal></title>
- <entry>(none), <literal>port</literal></entry>
+ <para>Possible arguments: (none), <literal>port</literal></para>
- <entry>Uses <application>readline</application> as a library
+ <para>Uses <application>readline</application> as a library
dependency, and sets <varname>CPPFLAGS</varname> and
<varname>LDFLAGS</varname> as necessary. If the
<literal>port</literal> argument is used or if readline
is not present in the base system, add a dependency on
- <package role="port">devel/readline</package></entry>
- </row>
+ <package role="port">devel/readline</package></para>
+ </sect1>
- <row xml:id="uses-scons">
- <entry><literal>scons</literal></entry>
+ <sect1 xml:id="uses-scons">
+ <title><literal>scons</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Provide support for the use of
- <package role="port">devel/scons</package></entry>
- </row>
+ <para>Provide support for the use of
+ <package role="port">devel/scons</package></para>
+ </sect1>
- <row xml:id="uses-shared-mime-info">
- <entry><literal>shared-mime-info</literal></entry>
+ <sect1 xml:id="uses-shared-mime-info">
+ <title><literal>shared-mime-info</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Uses <application>update-mime-database</application>
+ <para>Uses <application>update-mime-database</application>
from <package role="port">misc/shared-mime-info</package>.
This uses will automatically add a post-install step in
such a way that the port itself still can specify there
own post-install step if needed. It also add an <link
linkend="plist-keywords-shared-mime-info"><literal>@shared-mime-info</literal></link>
- entry to the plist.</entry>
- </row>
+ para to the plist.</para>
+ </sect1>
- <row xml:id="uses-shebangfix">
- <entry><literal>shebangfix</literal></entry>
+ <sect1 xml:id="uses-shebangfix">
+ <title><literal>shebangfix</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>A lot of software uses incorrect locations for script
+ <para>A lot of software uses incorrect locations for script
interpreters, most notably
<filename>/usr/bin/perl</filename> and
<filename>/bin/bash</filename>. This fixes shebang lines
@@ -1188,31 +1210,31 @@
<varname>lua_CMD</varname>. For example
<literal>SHEBANG_LANG=lua</literal>, then
<varname>lua_OLD_CMD=/usr/bin/lua</varname> and
- <varname>lua_CMD=${LOCALBASE}/bin/lua</varname>.</entry>
- </row>
+ <varname>lua_CMD=${LOCALBASE}/bin/lua</varname>.</para>
+ </sect1>
- <row xml:id="uses-tar">
- <entry><literal>tar</literal></entry>
+ <sect1 xml:id="uses-tar">
+ <title><literal>tar</literal></title>
- <entry>(none), <literal>Z</literal>, <literal>bz2</literal>,
+ <para>Possible arguments: (none), <literal>Z</literal>, <literal>bz2</literal>,
<literal>bzip2</literal>, <literal>lzma</literal>,
<literal>tbz</literal>, <literal>tgz</literal>,
- <literal>txz</literal>, <literal>xz</literal></entry>
+ <literal>txz</literal>, <literal>xz</literal></para>
- <entry>Set <varname>EXTRACT_SUFX</varname> to
+ <para>Set <varname>EXTRACT_SUFX</varname> to
<literal>.tar</literal>, <literal>.tar.Z</literal>,
<literal>.tar.bz2</literal>, <literal>.tar.bz2</literal>,
<literal>.tar.lzma</literal>, <literal>.tbz</literal>,
<literal>.tgz</literal>, <literal>.txz</literal> or
- <literal>.tar.xz</literal> respectively.</entry>
- </row>
+ <literal>.tar.xz</literal> respectively.</para>
+ </sect1>
- <row xml:id="uses-tcl">
- <entry><literal>tcl</literal></entry>
+ <sect1 xml:id="uses-tcl">
+ <title><literal>tcl</literal></title>
- <entry><literal>PORT</literal></entry>
+ <para>Possible arguments: <literal>PORT</literal></para>
- <entry>Add a dependency on <application>Tcl</application>.
+ <para>Add a dependency on <application>Tcl</application>.
The <literal>PORT</literal> parameter can be either
<literal>tcl</literal> or <literal>tk</literal>. Either a
version or wrapper dependency can be appended using
@@ -1269,27 +1291,27 @@
<para><varname>TK_INCLUDEDIR</varname>: path of the
<application>Tk</application> C header files</para>
</listitem>
- </itemizedlist></entry>
- </row>
+ </itemizedlist></para>
+ </sect1>
- <row xml:id="uses-tk">
- <entry><literal>tk</literal></entry>
+ <sect1 xml:id="uses-tk">
+ <title><literal>tk</literal></title>
- <entry>Same as arguments for <literal>tcl</literal></entry>
+ <para>Same as arguments for <literal>tcl</literal></para>
- <entry>Small wrapper when using both
+ <para>Small wrapper when using both
<application>Tcl</application> and
<application>Tk</application>. The same variables are
returned as when using
- <application>Tcl</application>.</entry>
- </row>
+ <application>Tcl</application>.</para>
+ </sect1>
- <row xml:id="uses-twisted">
- <entry><literal>twisted</literal></entry>
+ <sect1 xml:id="uses-twisted">
+ <title><literal>twisted</literal></title>
- <entry>(none), <literal>ARGS</literal></entry>
+ <para>Possible arguments: (none), <literal>ARGS</literal></para>
- <entry>Add a dependency on
+ <para>Add a dependency on
<application>twistedCore</application>. The list of
required components can be specified as a value of this
variable. <literal>ARGS</literal> can be one of:
@@ -1312,26 +1334,26 @@
<literal>run</literal>, one or more other supported
<application>twisted</application> components can be
specified. Supported values are listed in
- <filename>Uses/twisted.mk</filename>.</entry>
- </row>
+ <filename>Uses/twisted.mk</filename>.</para>
+ </sect1>
- <row xml:id="uses-uidfix">
- <entry><literal>uidfix</literal></entry>
+ <sect1 xml:id="uses-uidfix">
+ <title><literal>uidfix</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Changes some default behavior (mostly variables) of
+ <para>Changes some default behavior (mostly variables) of
the build system to allow installing this port as a normal
user. Try this in the port before adding
- <literal>NEED_ROOT=yes</literal></entry>
- </row>
+ <literal>NEED_ROOT=yes</literal></para>
+ </sect1>
- <row xml:id="uses-uniquefiles">
- <entry><literal>uniquefiles</literal></entry>
+ <sect1 xml:id="uses-uniquefiles">
+ <title><literal>uniquefiles</literal></title>
- <entry>(none), <literal>dirs</literal></entry>
+ <para>Possible arguments: (none), <literal>dirs</literal></para>
- <entry>Make files or directories 'unique', by adding a
+ <para>Make files or directories 'unique', by adding a
prefix or suffix. If the <literal>dirs</literal> argument
is used, the port needs a prefix (a only a prefix) based
on <varname>UNIQUE_PREFIX</varname> for standard
@@ -1365,15 +1387,15 @@
of files that need to be suffixed. Default:
empty.</para>
</listitem>
- </itemizedlist></entry>
- </row>
+ </itemizedlist></para>
+ </sect1>
- <row xml:id="uses-webplugin">
- <entry><literal>webplugin</literal></entry>
+ <sect1 xml:id="uses-webplugin">
+ <title><literal>webplugin</literal></title>
- <entry>(none), <literal>ARGS</literal></entry>
+ <para>Possible arguments: (none), <literal>ARGS</literal></para>
- <entry>Automatically create and remove symbolic links for
+ <para>Automatically create and remove symbolic links for
each application that supports the webplugin framework.
<literal>ARGS</literal> can be one of:
@@ -1427,15 +1449,14 @@
directory to install the plug-in files into, default
<varname>PKGBASE</varname>.</para>
</listitem>
- </itemizedlist></entry>
- </row>
+ </itemizedlist></para>
+ </sect1>
- <row xml:id="uses-xfce">
- <entry><literal>xfce</literal></entry>
+ <sect1 xml:id="uses-xfce">
+ <title><literal>xfce</literal></title>
- <entry>(none), <literal>gtk3</literal></entry>
+ <para>Possible arguments: (none), <literal>gtk3</literal></para>
- <entry>
<para>Provide support for <application>Xfce</application>
related ports. See <xref linkend="using-xfce"/> for
details.</para>
@@ -1444,32 +1465,28 @@
the port requires <application>GTK3</application>
features provided by <package
role="port">x11/libxfce4menu</package>.</para>
- </entry>
- </row>
+ </sect1>
- <row xml:id="uses-zip">
- <entry><literal>zip</literal></entry>
+ <sect1 xml:id="uses-zip">
+ <title><literal>zip</literal></title>
- <entry>(none), <literal>infozip</literal></entry>
+ <para>Possible arguments: (none), <literal>infozip</literal></para>
- <entry>Indicates that the distribution files use the ZIP
+ <para>Indicates that the distribution files use the ZIP
compression algorithm. For files using the InfoZip
algorithm the <literal>infozip</literal> argument must be
- passed to set the appropriate dependencies.</entry>
- </row>
+ passed to set the appropriate dependencies.</para>
+ </sect1>
- <row xml:id="uses-zope">
- <entry><literal>zope</literal></entry>
+ <sect1 xml:id="uses-zope">
+ <title><literal>zope</literal></title>
- <entry>(none)</entry>
+ <para>Possible arguments: (none)</para>
- <entry>Uses <package role="port">www/zope</package>. Mostly
+ <para>Uses <package role="port">www/zope</package>. Mostly
used for building <application>zope</application> related
ports. <varname>ZOPE_VERSION</varname> can be used by a
port to indicate that a specific version of
- <application>zope</application> shall be used.</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <application>zope</application> shall be used.</para>
+ </sect1>
</chapter>
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Tue, Mar 17, 3:11 AM (13 h, 39 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
29805121
Default Alt Text
D3142.diff (53 KB)
Attached To
Mode
D3142: Convert the USES table into multiple <sect1>.
Attached
Detach File
Event Timeline
Log In to Comment