Date: Wed, 16 Jul 2014 20:07:57 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r45317 - in head/en_US.ISO8859-1/books/porters-handbook: uses versions Message-ID: <201407162007.s6GK7vSf078924@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201407162007.s6GK7vSf078924>