svn commit: r45317 - in head/en_US.ISO8859-1/books/porters-handbook: uses versions
Warren Block <[email protected]>
| Newsgroups | gmane.os.freebsd.devel.cvs.doc |
|---|---|
| Message-ID | <[email protected]> |
Author: wblock
Date: Wed Jul 16 20:07:57 2014
New Revision: 45317
URL: http://svnweb.freebsd.org/changeset/doc/45317
Log:
Whitespace-only fixes, indentation and wrapping long lines.
Translators, please ignore.
Modified:
head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
head/en_US.ISO8859-1/books/porters-handbook/versions/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 Wed Jul 16 20:02:06 2014 (r45316)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed Jul 16 20:07:57 2014 (r45317)
@@ -14,7 +14,9 @@
<row xml:id="uses-FEATURE">
<entry><literal>FEATURE</literal></entry>
+
<entry>ARGUMENTS</entry>
+
<entry>DESCRIPTION</entry>
</row>
@@ -22,329 +24,369 @@
<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>
-
- <table xml:id="uses-values-table">
- <title>Values of <varname>USES</varname></title>
-
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Feature</entry>
- <entry>Arguments</entry>
- <entry>Description</entry>
- </row>
- </thead>
-
- <tbody valign="top">
-
-<row xml:id="uses-ada">
- <entry><literal>ada</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Depends on an <application>Ada</application>-capable
- compiler, and sets <varname>CC</varname> accordingly.</entry>
-</row>
-
-<row xml:id="uses-bison">
- <entry><literal>bison</literal></entry>
-
- <entry>(none), <literal>build</literal>, <literal>run</literal>,
- <literal>both</literal></entry>
-
- <entry>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>
-
-<row xml:id="uses-charsetfix">
- <entry><literal>charsetfix</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Prevents the port from installing
- <filename>charset.alias</filename>. This should 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
- <varname>WRKSRC</varname>/<filename>Makefile.in</filename>.</entry>
-</row>
-
-<row xml:id="uses-cmake">
- <entry><literal>cmake</literal></entry>
-
- <entry>(none), <literal>outsource</literal>,
- <literal>run</literal></entry>
-
- <entry>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>
-
-<row xml:id="uses-compiler">
- <entry><literal>compiler</literal></entry>
-
- <entry>(none), <literal>c++0x</literal>,
- <literal>c++11-lang</literal>, <literal>c++11-lib</literal>,
- <literal>c11</literal>, <literal>openmp</literal>,
- <literal>nestedfct</literal>, <literal>features</literal></entry>
-
- <entry>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, and <literal>c++11-lib</literal> if the
- port also needs a C++11-ready standard library. If the port needs
- a compiler understanding C++0X, C11, OpenMP, or nested functions,
- the corresponding parameters can be used. Use
- <literal>features</literal> to request a list of features
- supported by the default compiler. After including
- <filename>bsd.port.pre.mk</filename> the port can inspect the
- results using these variables:
-
- <itemizedlist>
- <listitem>
- <para><varname>COMPILER_TYPE</varname>: the default compiler
- on the system, either gcc or clang</para>
- </listitem>
-
- <listitem>
- <para><varname>ALT_COMPILER_TYPE</varname>: the alternative
- compiler on the system, either gcc or clang. Only set if
- two compilers are present in the base
- system.</para>
- </listitem>
-
- <listitem>
- <para><varname>COMPILER_VERSION</varname>: the first two
- digits of the version of the default compiler.</para>
- </listitem>
-
- <listitem>
- <para><varname>ALT_COMPILER_VERSION</varname>: the first two
- digits of the version of the alternative compiler, if
- present.</para>
- </listitem>
-
- <listitem>
- <para><varname>CHOSEN_COMPILER_TYPE</varname>: the chosen
- compiler, either gcc or clang</para>
- </listitem>
-
- <listitem>
- <para><varname>COMPILER_FEATURES</varname>: the features
- supported by the default compiler. It currently lists the
- C++ library.</para>
- </listitem>
- </itemizedlist></entry>
-</row>
-
-<row xml:id="uses-cran">
- <entry><literal>cran</literal></entry>
+ <title xml:id="uses-values">Values of
+ <varname>USES</varname></title>
- <entry>(none), <literal>auto-plist</literal></entry>
+ <table xml:id="uses-values-table">
+ <title>Values of <varname>USES</varname></title>
- <entry>Uses the Comprehensive R Archive Network. Specify
- <varname>auto-plist</varname> to automatically generate
- <filename>pkg-plist</filename>.</entry>
-</row>
-
-<row xml:id="uses-desktop-file-utils">
- <entry><literal>desktop-file-utils</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>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>. Lines will be inserted into the
- plist to run <application>update-desktop-database</application> on
- package install or removal.</entry>
-</row>
-
-<row xml:id="uses-desthack">
- <entry><literal>desthack</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Changes the behavior of GNU configure to properly support
- <varname>DESTDIR</varname> in case the original software does
- not.</entry>
-</row>
-
-<row xml:id="uses-display">
- <entry><literal>display</literal></entry>
-
- <entry>(none), ARGS</entry>
-
- <entry>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 extended with the port
- number of the currently running 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>
-
-<row xml:id="uses-dos2unix">
- <entry><literal>dos2unix</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>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 <emphasis>all</emphasis> files,
- including binaries. See <xref
- linkend="slow-patch-automatic-replacements"/> for examples.
-
- <itemizedlist>
- <listitem>
- <para><varname>DOS2UNIX_REGEX</varname>: match file names
- based on a regular expression.</para>
- </listitem>
-
- <listitem>
- <para><varname>DOS2UNIX_FILES</varname>: match literal file
- names.</para>
- </listitem>
-
- <listitem>
- <para><varname>DOS2UNIX_GLOB</varname>: match file names based
- on a glob pattern.</para>
- </listitem>
- </itemizedlist></entry>
-</row>
-
-<row xml:id="uses-fam">
- <entry><literal>fam</literal></entry>
-
- <entry>(none), fam, gamin</entry>
-
- <entry>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>
-
-<row xml:id="uses-fmake">
- <entry><literal>fmake</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Uses <package role="port">devel/fmake</package> as a
- build-time dependency.</entry>
-</row>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Feature</entry>
+
+ <entry>Arguments</entry>
+
+ <entry>Description</entry>
+ </row>
+ </thead>
+
+ <tbody valign="top">
+ <row xml:id="uses-ada">
+ <entry><literal>ada</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>Depends on an <application>Ada</application>-capable
+ compiler, and sets <varname>CC</varname>
+ accordingly.</entry>
+ </row>
+
+ <row xml:id="uses-bison">
+ <entry><literal>bison</literal></entry>
+
+ <entry>(none), <literal>build</literal>,
+ <literal>run</literal>, <literal>both</literal></entry>
+
+ <entry>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>
+
+ <row xml:id="uses-charsetfix">
+ <entry><literal>charsetfix</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>Prevents the port from installing
+ <filename>charset.alias</filename>. This should 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
+ <varname>WRKSRC</varname>/<filename>Makefile.in</filename>.</entry>
+ </row>
+
+ <row xml:id="uses-cmake">
+ <entry><literal>cmake</literal></entry>
+
+ <entry>(none), <literal>outsource</literal>,
+ <literal>run</literal></entry>
+
+ <entry>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>
+
+ <row xml:id="uses-compiler">
+ <entry><literal>compiler</literal></entry>
+
+ <entry>(none), <literal>c++0x</literal>,
+ <literal>c++11-lang</literal>,
+ <literal>c++11-lib</literal>, <literal>c11</literal>,
+ <literal>openmp</literal>, <literal>nestedfct</literal>,
+ <literal>features</literal></entry>
+
+ <entry>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, and
+ <literal>c++11-lib</literal> if the port also needs a
+ C++11-ready standard library. If the port needs a
+ compiler understanding C++0X, C11, OpenMP, or nested
+ functions, the corresponding parameters can be used. Use
+ <literal>features</literal> to request a list of features
+ supported by the default compiler. After including
+ <filename>bsd.port.pre.mk</filename> the port can inspect
+ the results using these variables:
+
+ <itemizedlist>
+ <listitem>
+ <para><varname>COMPILER_TYPE</varname>: the default
+ compiler on the system, either gcc or clang</para>
+ </listitem>
+
+ <listitem>
+ <para><varname>ALT_COMPILER_TYPE</varname>: the
+ alternative compiler on the system, either gcc or
+ clang. Only set if two compilers are present in the
+ base system.</para>
+ </listitem>
+
+ <listitem>
+ <para><varname>COMPILER_VERSION</varname>: the first
+ two digits of the version of the default
+ compiler.</para>
+ </listitem>
+
+ <listitem>
+
+ <para><varname>ALT_COMPILER_VERSION</varname>: the
+ first two digits of the version of the alternative
+ compiler, if present.</para>
+ </listitem>
+
+ <listitem>
+ <para><varname>CHOSEN_COMPILER_TYPE</varname>: the
+ chosen compiler, either gcc or clang</para>
+ </listitem>
+
+ <listitem>
+ <para><varname>COMPILER_FEATURES</varname>: the
+ features supported by the default compiler. It
+ currently lists the C++ library.</para>
+ </listitem>
+ </itemizedlist></entry>
+ </row>
+
+ <row xml:id="uses-cran">
+ <entry><literal>cran</literal></entry>
+
+ <entry>(none), <literal>auto-plist</literal></entry>
+
+ <entry>Uses the Comprehensive R Archive Network. Specify
+ <varname>auto-plist</varname> to automatically generate
+ <filename>pkg-plist</filename>.</entry>
+ </row>
+
+ <row xml:id="uses-desktop-file-utils">
+ <entry><literal>desktop-file-utils</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>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>. Lines will be inserted
+ into the plist to run
+ <application>update-desktop-database</application> on
+ package install or removal.</entry>
+ </row>
+
+ <row xml:id="uses-desthack">
+ <entry><literal>desthack</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>Changes the behavior of GNU configure to properly
+ support <varname>DESTDIR</varname> in case the original
+ software does not.</entry>
+ </row>
+
+ <row xml:id="uses-display">
+ <entry><literal>display</literal></entry>
+
+ <entry>(none), ARGS</entry>
+
+ <entry>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
+ extended with the port number of the currently running
+ 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>
+
+ <row xml:id="uses-dos2unix">
+ <entry><literal>dos2unix</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>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
+ <emphasis>all</emphasis> files, including binaries. See
+ <xref linkend="slow-patch-automatic-replacements"/> for
+ examples.
+
+ <itemizedlist>
+ <listitem>
+ <para><varname>DOS2UNIX_REGEX</varname>: match file
+ names based on a regular expression.</para>
+ </listitem>
+
+ <listitem>
+ <para><varname>DOS2UNIX_FILES</varname>: match literal
+ file names.</para>
+ </listitem>
+
+ <listitem>
+ <para><varname>DOS2UNIX_GLOB</varname>: match file
+ names based on a glob pattern.</para>
+ </listitem>
+ </itemizedlist></entry>
+ </row>
+
+ <row xml:id="uses-fam">
+ <entry><literal>fam</literal></entry>
+
+ <entry>(none), fam, gamin</entry>
+
+ <entry>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>
+
+ <row xml:id="uses-fmake">
+ <entry><literal>fmake</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>Uses <package role="port">devel/fmake</package> as a
+ build-time dependency.</entry>
+ </row>
+
+ <row xml:id="uses-fortran">
+ <entry><literal>fortran</literal></entry>
+
+ <entry><literal>gcc</literal> (default),
+ <literal>ifort</literal></entry>
+
+ <entry>Uses the Fortran compiler from either GNU or
+ Intel.</entry>
+ </row>
+
+ <row xml:id="uses-fuse">
+ <entry><literal>fuse</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>The port will depend on the FUSE library and handle
+ the dependency on the kernel module depending on the
+ version of &os;.</entry>
+ </row>
+
+ <row xml:id="uses-gettext">
+ <entry><literal>gettext</literal></entry>
+
+ <entry>(none), <literal>lib</literal> (default),
+ <literal>build</literal>, <literal>run</literal></entry>
+
+ <entry>Uses <package role="port">devel/gettext</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>xgettext</filename>.</entry>
+ </row>
+
+ <row xml:id="uses-gmake">
+ <entry><literal>gmake</literal></entry>
+
+ <entry>(none)</entry>
+
+ <entry>Uses <package role="port">devel/gmake</package> 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>
+
+ <row xml:id="uses-gssapi">
+ <entry><literal>gssapi</literal></entry>
+
+ <entry>(none), <literal>base</literal> (default),
+ <literal>heimdal</literal>, <literal>mit</literal>,
+ <literal>flags</literal>,
+ <literal>bootstrap</literal></entry>
+
+ <entry>
+ <para>Handle dependencies needed by consumers of the
+ <acronym>GSS-API</acronym>. Only libraries that provide
+ the <application>Kerberos</application> mechanism are
+ available. By default, or set to
+ <literal>base</literal>, the <acronym>GSS-API</acronym>
+ library from the base system is used. Can also be set
+ to <literal>heimdal</literal> to use
+ <package role="port">security/heimdal</package>, or
+ <literal>mit</literal> to use
+ <package role="port">security/krb5</package>.</para>
+
+ <para>When the local <application>Kerberos</application>
+ installation is not in <varname>LOCALBASE</varname>, set
+ <varname>HEIMDAL_HOME</varname> (for
+ <literal>heimdal</literal>) or
+ <varname>KRB5_HOME</varname> (for
+ <literal>krb5</literal>) to the location of the
+ <application>Kerberos</application> installation.</para>
+
+ <para>These variables are exported for the ports to
+ use:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para><varname>GSSAPIBASEDIR</varname></para>
+ </listitem>
+
+ <listitem>
+ <para><varname>GSSAPICPPFLAGS</varname></para>
+ </listitem>
+
+ <listitem>
+ <para><varname>GSSAPIINCDIR</varname></para>
+ </listitem>
+
+ <listitem>
+ <para><varname>GSSAPILDFLAGS</varname></para>
+ </listitem>
+
+ <listitem>
+ <para><varname>GSSAPILIBDIR</varname></para>
+ </listitem>
+
+ <listitem>
+ <para><varname>GSSAPILIBS</varname></para>
+ </listitem>
+
+ <listitem>
+ <para><varname>GSSAPI_CONFIGURE_ARGS</varname></para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The <literal>flags</literal> option can be given
+ alongside <literal>base</literal>,
+ <literal>heimdal</literal>, or <literal>mit</literal> to
+ automatically add <varname>GSSAPICPPFLAGS</varname>,
+ <varname>GSSAPILDFLAGS</varname>, and
+ <varname>GSSAPILIBS</varname> to
+ <varname>CFLAGS</varname>, <varname>LDFLAGS</varname>,
+ and <varname>LDADD</varname>, respectively. For
+ example, use <literal>base,flags</literal>.</para>
+
+ <para>The <literal>bootstrap</literal> option is a special
+ prefix only for use by
+ <package role="port">security/krb5</package> and
+ <package role="port">security/heimdal</package>. For
+ example, use <literal>bootstrap,mit</literal>.</para>
-<row xml:id="uses-fortran">
- <entry><literal>fortran</literal></entry>
+ <example>
+ <title>Typical Use</title>
- <entry><literal>gcc</literal> (default),
- <literal>ifort</literal></entry>
-
- <entry>Uses the Fortran compiler from either GNU or Intel.</entry>
-</row>
-
-<row xml:id="uses-fuse">
- <entry><literal>fuse</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>The port will depend on the FUSE library and handle the
- dependency on the kernel module depending on the version of
- &os;.</entry>
-</row>
-
-<row xml:id="uses-gettext">
- <entry><literal>gettext</literal></entry>
-
- <entry>(none), <literal>lib</literal> (default),
- <literal>build</literal>, <literal>run</literal></entry>
-
- <entry>Uses <package role="port">devel/gettext</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>xgettext</filename>.</entry>
-</row>
-
-<row xml:id="uses-gmake">
- <entry><literal>gmake</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Uses <package role="port">devel/gmake</package> 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>
-
-<row xml:id="uses-gssapi">
- <entry><literal>gssapi</literal></entry>
-
- <entry>(none), <literal>base</literal> (default),
- <literal>heimdal</literal>, <literal>mit</literal>,
- <literal>flags</literal>, <literal>bootstrap</literal></entry>
-
- <entry>
- <para>Handle dependencies needed by consumers of the
- <acronym>GSS-API</acronym>. Only libraries that provide the
- <application>Kerberos</application> mechanism are available.
- By default, or set to <literal>base</literal>,
- the <acronym>GSS-API</acronym> library from the base system is used.
- Can also be set to <literal>heimdal</literal> to use <package
- role="port">security/heimdal</package>, or
- <literal>mit</literal> to use <package
- role="port">security/krb5</package>.</para>
-
- <para>When the local <application>Kerberos</application>
- installation is not in <varname>LOCALBASE</varname>, set
- <varname>HEIMDAL_HOME</varname> (for <literal>heimdal</literal>)
- or <varname>KRB5_HOME</varname> (for <literal>krb5</literal>) to
- the location of the <application>Kerberos</application>
- installation.</para>
-
- <para>These variables are exported for the ports to use:</para>
-
- <itemizedlist>
- <listitem><para><varname>GSSAPIBASEDIR</varname></para></listitem>
- <listitem><para><varname>GSSAPICPPFLAGS</varname></para></listitem>
- <listitem><para><varname>GSSAPIINCDIR</varname></para></listitem>
- <listitem><para><varname>GSSAPILDFLAGS</varname></para></listitem>
- <listitem><para><varname>GSSAPILIBDIR</varname></para></listitem>
- <listitem><para><varname>GSSAPILIBS</varname></para></listitem>
- <listitem><para><varname>GSSAPI_CONFIGURE_ARGS</varname></para></listitem>
- </itemizedlist>
-
- <para>The <literal>flags</literal> option can be given alongside
- <literal>base</literal>, <literal>heimdal</literal>, or
- <literal>mit</literal> to automatically add
- <varname>GSSAPICPPFLAGS</varname>,
- <varname>GSSAPILDFLAGS</varname>, and
- <varname>GSSAPILIBS</varname> to <varname>CFLAGS</varname>,
- <varname>LDFLAGS</varname>, and <varname>LDADD</varname>,
- respectively. For example, use
- <literal>base,flags</literal>.</para>
-
- <para>The <literal>bootstrap</literal> option is a special prefix
- only for use by <package role="port">security/krb5</package>
- and <package role="port">security/heimdal</package>. For
- example, use <literal>bootstrap,mit</literal>.</para>
-
- <example>
- <title>Typical Use</title>
-
- <programlisting>OPTIONS_SINGLE= GSSAPI
+ <programlisting>OPTIONS_SINGLE= GSSAPI
OPTIONS_SINGLE_GSSAPI= GSSAPI_BASE GSSAPI_HEIMDAL GSSAPI_MIT GSSAPI_NONE
GSSAPI_BASE_USES= gssapi
@@ -354,621 +396,668 @@ 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>
-
-<row xml:id="uses-iconv">
- <entry><literal>iconv</literal></entry>
-
- <entry>(none), <literal>lib</literal>, <literal>build</literal>,
- <literal>patch</literal></entry>
-
- <entry>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 system on 10-CURRENT
- after a native <command>iconv</command> was committed in
- <revnumber>254273</revnumber>. By default, with no arguments or
- with the <literal>lib</literal> argument, implies
- <command>iconv</command> with build-time and run-time
- dependencies. <literal>build</literal> implies a build-time
- dependency, and <literal>patch</literal> implies a patch-time
- dependency. For more information see
- <xref linkend="using-iconv"/>.</entry>
-</row>
-
-<row xml:id="uses-imake">
- <entry><literal>imake</literal></entry>
-
- <entry>(none), <literal>env</literal>,
- <literal>notall</literal></entry>
-
- <entry>Uses <package role="port">devel/imake</package> as
- build-time dependency. If the <literal>env</literal> argument is
- given, only setup the environment and do not define any target.
- If the <literal>notall</literal> argument is given does not pass
- <literal>-a</literal> to <command>xmkmf</command>.</entry>
-</row>
-
-<row xml:id="uses-kmod">
- <entry><literal>kmod</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Fills in the boilerplate for kernel module ports, currently:
-
- <itemizedlist>
- <listitem>
- <para>Add <literal>kld</literal> to
- <varname>CATEGORIES</varname>.</para>
- </listitem>
-
- <listitem>
- <para>Set <varname>SSP_UNSAFE</varname>.</para>
- </listitem>
-
- <listitem>
- <para>Set <varname>IGNORE</varname> if the kernel sources are
- not found in <varname>SRC_BASE</varname>.</para>
- </listitem>
-
- <listitem>
- <para>Define <varname>KMODDIR</varname> to
- <filename class="directory">/boot/modules</filename> by
- default, add it to <varname>PLIST_SUB</varname> and
- <varname>MAKE_ENV</varname>, and create it upon
- installation. If <varname>KMODDIR</varname> is set to
- <filename class="directory">/boot/kernel</filename>, it will
- be rewritten to
- <filename class="directory">/boot/modules</filename>. This
- prevents breaking packages when upgrading the kernel due to
- <filename class="directory">/boot/kernel</filename> being
- renamed to
- <filename class="directory">/boot/kernel.old</filename> in
- the process.</para>
- </listitem>
-
- <listitem>
- <para>Handle cross-referencing kernel modules upon
- installation and deinstallation.</para>
- </listitem>
- </itemizedlist></entry>
-</row>
-
-<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>
-
-<row xml:id="uses-libtool">
- <entry><literal>libtool</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Patches <command>libtool</command> scripts. This should be
- added to all ports that use <command>libtool</command>.</entry>
-</row>
-
-<row xml:id="uses-lua">
- <entry><literal>lua</literal></entry>
-
- <entry>(none), <literal>XY+</literal>, <literal>XY</literal>,
- <literal>build</literal>, <literal>run</literal></entry>
-
- <entry>Adds a dependency on <application>Lua</application>. By
- default this is a library undependency, unless overridden by the
- <literal>build</literal> or <literal>run</literal> option. The
- default version is 5.2, unless set by the <literal>XY</literal>
- parameter (e.g., <literal>51</literal> or
- <literal>52+</literal>).</entry>
-</row>
-
-<row xml:id="uses-makeself">
- <entry><literal>makeself</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Indicates that the distribution files are makeself
- archives and sets the appropriate dependencies.</entry>
-</row>
-
-<row xml:id="uses-mono">
- <entry><literal>mono</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Adds a dependency on the <application>Mono</application>
- (currently only C#) framework by setting the appropriate
- dependencies.</entry>
-</row>
-
-<row xml:id="uses-motif">
- <entry><literal>motif</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>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>
-
-<row xml:id="uses-ncurses">
- <entry><literal>ncurses</literal></entry>
-
- <entry>(none), <literal>base</literal>,
- <literal>port</literal></entry>
-
- <entry>Uses <application>ncurses</application>, and causes some
- useful variables to be set.</entry>
-</row>
-
-<row xml:id="uses-ninja">
- <entry><literal>ninja</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Uses <application>ninja</application> to build the port. End
- users can set <varname>NINJA_VERBOSE</varname> for verbose
- output.</entry>
-</row>
-
-<row xml:id="uses-openal">
- <entry><literal>openal</literal></entry>
-
- <entry><literal>al</literal>, <literal>soft</literal> (default),
- <literal>si</literal>, <literal>alut</literal></entry>
-
- <entry>Uses <application>OpenAL</application>. The backend can be
- specified, with the software implementation as the default. The
- user can specify a preferred backend with the
- <varname>WANT_OPENAL</varname> knob. Valid values for this knob
- are <literal>soft</literal> (default) and
- <literal>si</literal>.</entry>
-</row>
-
-<row xml:id="uses-pathfix">
- <entry><literal>pathfix</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Look for the <filename>Makefile.in</filename> and
- <filename>configure</filename> files in the port's associated
- sources and fix common paths to make sure they respect the &os;
- hierarchy.</entry>
-</row>
-
-<row xml:id="uses-perl5">
- <entry><literal>perl5</literal></entry>
-
- <entry>(none)</entry>
-
- <entry>Depends on <application>Perl</application>. These variables
- can be set:
-
- <itemizedlist>
- <listitem>
- <para><varname>PERL_VERSION</varname>: Full version of
- <application>Perl</application> to use, or the default if
- not set</para>
- </listitem>
-
- <listitem>
- <para><varname>PERL_ARCH</varname>: Directory name of
- architecture dependent libraries, defaults to
- <filename class="directory">mach</filename></para>
- </listitem>
-
- <listitem>
- <para><varname>PERL_PORT</varname>: Name of the
- <application>Perl</application> port to be installed, the
- default is derived from
- <varname>PERL_VERSION</varname></para>
- </listitem>
-
- <listitem>
- <para><varname>SITE_PERL</varname>: Directory name for
- site specific <application>Perl</application>
- packages</para>
- </listitem>
-
- <listitem>
- <para><varname>USE_PERL5</varname>: Phases in which to
- use <application>Perl</application>, can be
- <literal>extract</literal>, <literal>patch</literal>,
- <literal>build</literal>, <literal>install</literal>, or
- <literal>run</literal>. It can also be
- <literal>configure</literal>, <literal>modbuild</literal>,
- or <literal>modbuildtiny</literal> when
- <filename>Makefile.PL</filename>,
- <filename>Build.PL</filename>, or the Module::Build::Tiny
- flavor of <filename>Build.PL</filename> is required. If
- there is a <filename>.packlist</filename> referencing
- <varname>${STAGEDIR}</varname>, then
- <literal>fixpacklist</literal> should be used to patch it.
- It defaults to <literal>build run</literal>.</para>
- </listitem>
- </itemizedlist></entry>
-</row>
-
-<row xml:id="uses-pgsql">
- <entry><literal>pgsql</literal></entry>
-
- <entry>(none), <literal>X.Y</literal>, <literal>X.Y+</literal>,
- <literal>X.Y-</literal></entry>
-
- <entry>
- <para>Provide support for PostgreSQL. Maintainer can set version
- required. Minimum and maximum versions can be specified; e.g.,
- 9.0-, 8.4+.</para>
-
- <para>Add PostgreSQL component dependency, using
- <literal>WANT_PGSQL=component[:target]</literal>. e.g.,
- <literal>WANT_PGSQL=server:configure pltcl plperl</literal> For
- the full list use
- <command>make -V _USE_PGSQL_DEP</command>.</para></entry>
-</row>
-
-<row xml:id="uses-pkgconfig">
- <entry><literal>pkgconfig</literal></entry>
-
- <entry>(none), <literal>build</literal> (default),
- <literal>run</literal>, <literal>both</literal></entry>
-
- <entry>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>
-
-<row xml:id="uses-pure">
- <entry><literal>pure</literal></entry>
-
- <entry>(none), <literal>ffi</literal></entry>
-
- <entry>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>
-
-<row xml:id="uses-qmail">
- <entry><literal>qmail</literal></entry>
-
- <entry>(none), <literal>build</literal>, <literal>run</literal>,
- <literal>both</literal>, <literal>vars</literal></entry>
-
- <entry>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>
*** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"