svn commit: r47055 - head/en_US.ISO8859-1/books/porters-handbook/uses
Mathieu Arnold
mat at FreeBSD.org
Thu Jul 23 14:27:37 UTC 2015
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 ***
More information about the svn-doc-all
mailing list