Whitespace-only fixes, translators please ignore.

This commit is contained in:
Warren Block 2013-12-08 18:04:01 +00:00
parent 4a83d7bfb1
commit 8ebcaf60e1
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=43302
2 changed files with 699 additions and 466 deletions

File diff suppressed because it is too large Load diff

View file

@ -4,9 +4,9 @@
$FreeBSD$
This file documents the values of the USES make variable. The format is
easy to grasp from the already-added entries below (or use this scheme
below as a skeleton):
This file documents the values of the USES make variable. The
format is easy to grasp from the already-added entries below (or use
this scheme below as a skeleton):
<row>
<entry><literal>FEATURE</literal></entry>
@ -18,6 +18,7 @@
<row>
<entry><literal>ada</literal></entry>
<entry>(none)</entry>
<entry>Depends on an <application>Ada</application>-capable
@ -26,19 +27,24 @@
<row>
<entry><literal>bison</literal></entry>
<entry>(none), <literal>build</literal>, <literal>run</literal>,
<literal>both</literal></entry>
<entry>Implies that the port uses <package>devel/bison</package> in one way or another. By
default, with no arguments or with the <literal>build</literal>
argument, it implies <command>bison</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
<entry>Implies that the port uses <package>devel/bison</package> in
one way or another. By default, with no arguments or with the
<literal>build</literal> argument, it implies
<command>bison</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>
<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>converters/libiconv</package>.
@ -50,6 +56,7 @@
<row>
<entry><literal>cmake</literal></entry>
<entry>(none), <literal>outsource</literal></entry>
<entry>The port will use <application>CMake</application> for
@ -60,6 +67,7 @@
<row>
<entry><literal>compiler</literal></entry>
<entry>(none), <literal>c++11-lang</literal>,
<literal>c++11-lib</literal>, <literal>c11</literal>,
<literal>openmp</literal>, <literal>features</literal></entry>
@ -69,39 +77,57 @@
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 C11 or OpenMP, 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:
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>
<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>
<entry><literal>desktop-file-utils</literal></entry>
<entry>(none)</entry>
<entry>Implies that the port uses the
<application>update-desktop-database</application> from
<package>devel/desktop-file-utils</package>. An
extra post-install step will be run without interfering with any
<package>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
@ -110,6 +136,7 @@
<row>
<entry><literal>display</literal></entry>
<entry>(none), <literal>ARGS</literal></entry>
<entry>Set up a virtual display environment. If the environment
@ -124,31 +151,44 @@
<row>
<entry><literal>dos2unix</literal></entry>
<entry>(none)</entry>
<entry>The port has files with line endings in DOS format which need
to be converted. Three variables can be set to control which files
will be converted. The default is to convert
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.
<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>
<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>
<entry><literal>fmake</literal></entry>
<entry>(none)</entry>
<entry>Implies that the port uses <package>devel/fmake</package> as build-time
dependency.</entry>
<entry>Implies that the port uses <package>devel/fmake</package> as
build-time dependency.</entry>
</row>
<row>
<entry><literal>fuse</literal></entry>
<entry>(none)</entry>
<entry>Implies the port will depend on the FUSE library and handle
@ -158,11 +198,12 @@
<row>
<entry><literal>gettext</literal></entry>
<entry>(none), <literal>lib</literal>, <literal>build</literal>,
<literal>run</literal></entry>
<entry>Implies that the port uses
<package>devel/gettext</package> in one way or
another. By default, with no arguments or with the
<entry>Implies that the port uses <package>devel/gettext</package>
in one way or another. By default, with no arguments or with the
<literal>lib</literal> argument, implies
<command>gettext</command> with build-time and run-time
dependencies, <literal>build</literal> implies a build-time
@ -172,23 +213,26 @@
<row>
<entry><literal>gmake</literal></entry>
<entry>(none)</entry>
<entry>Implies that the port uses <package>devel/gmake</package> as build-time
dependency.</entry>
<entry>Implies that the port uses <package>devel/gmake</package> as
build-time dependency.</entry>
</row>
<row>
<entry><literal>iconv</literal></entry>
<entry>(none), <literal>lib</literal>, <literal>build</literal>,
<literal>patch</literal></entry>
<entry>Implies that the port uses <command>iconv</command>
functions, either from the port
<package>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
<package>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
@ -198,53 +242,76 @@
<row>
<entry><literal>imake</literal></entry>
<entry>(none)</entry>
<entry>Implies that the port uses <package>devel/imake</package> as build-time
dependency.</entry>
<entry>Implies that the port uses <package>devel/imake</package> as
build-time dependency.</entry>
</row>
<row>
<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>
<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>
<entry><literal>motif</literal></entry>
<entry>(none)</entry>
<entry>Implies that the ports uses
<package>devel/open-motif</package> as a library
dependency. End users can set <varname>WANT_LESSTIF</varname>
for the dependency to be on
<package>devel/lesstif</package> instead of
<package>devel/open-motif</package> as a library dependency. End
users can set <varname>WANT_LESSTIF</varname> for the dependency
to be on <package>devel/lesstif</package> instead of
<package>devel/open-motif</package>.</entry>
</row>
<row>
<entry><literal>ncurses</literal></entry>
<entry>(none), <literal>base</literal>,
<literal>port</literal></entry>
<entry>Implies that the port uses
<application>ncurses</application>, and causes some useful
variables to be set.</entry>
@ -252,7 +319,9 @@
<row>
<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;
@ -261,33 +330,51 @@
<row>
<entry><literal>perl5</literal></entry>
<entry>(none)</entry>
<entry>Implies a dependency on <application>Perl</application>. The
following variables can be set:<itemizedlist>
<listitem><para><varname>PERL_VERSION</varname>: Full version of
following 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
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
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
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. Defaults to
<literal>build run</literal>.</para></listitem>
<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.
Defaults to <literal>build run</literal>.</para>
</listitem>
</itemizedlist></entry>
</row>
@ -297,30 +384,36 @@
<entry>(none), <literal>build</literal>, <literal>run</literal>,
<literal>both</literal></entry>
<entry>Implies that the port uses <package>devel/pkgconf</package> in one way or another.
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
<entry>Implies that the port uses <package>devel/pkgconf</package>
in one way or another. 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>
<entry><literal>pure</literal></entry>
<entry>(none), <literal>ffi</literal></entry>
<entry>Implies that the port uses <package>lang/pure</package> in one way or another,
but largely is used for building related pure ports.
With the <literal>ffi</literal> argument, it implies <package>devel/pure-ffi</package>
as a run-time dependency.</entry>
<entry>Implies that the port uses <package>lang/pure</package> in
one way or another, but largely is used for building related pure
ports. With the <literal>ffi</literal> argument, it implies
<package>devel/pure-ffi</package> as a run-time
dependency.</entry>
</row>
<row>
<entry><literal>qmail</literal></entry>
<entry>(none), <literal>build</literal>, <literal>run</literal>,
<literal>both</literal>, <literal>vars</literal></entry>
<entry>Implies that the port uses <package>mail/qmail</package> in one way or another.
With the <literal>build</literal> argument, it implies
<command>qmail</command> as a build-time dependency.
<entry>Implies that the port uses <package>mail/qmail</package> in
one way or another. 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>
@ -329,6 +422,7 @@
<row>
<entry><literal>qmake</literal></entry>
<entry>(none), <literal>norecursive</literal></entry>
<entry>The port will use <application>QMake</application> for
@ -338,7 +432,9 @@
<row>
<entry><literal>readline</literal></entry>
<entry>(none), port</entry>
<entry>Implies that the port uses
<application>readline</application> as library dependency, and
sets <varname>CPPFLAGS</varname> and <varname>LDFLAGS</varname> as
@ -347,22 +443,24 @@
<row>
<entry><literal>shared-mime-info</literal></entry>
<entry>(none)</entry>
<entry>Implies that the port uses
<application>update-mime-database</application> from
<package>misc/shared-mime-info</package>. This
uses will automatically add a post-install step in such a way that
the port itself still can specify there own post-install step if
needed. It also insert lines into the plist for package install
and removal to run
<application>update-mime-data</application> with the correct
arguments.</entry>
<package>misc/shared-mime-info</package>. This uses will
automatically add a post-install step in such a way that the port
itself still can specify there own post-install step if needed.
It also insert lines into the plist for package install and
removal to run <application>update-mime-data</application> with
the correct arguments.</entry>
</row>
<row>
<entry><literal>shebangfix</literal></entry>
<entry>(none)</entry>
<entry>A lot of software uses incorrect locations for script
interpreters, most notably <filename>/usr/bin/perl</filename> and
<filename>/bin/bash</filename>. This fixes shebang lines in
@ -372,19 +470,19 @@
<application>Bash</application>, <application>Ruby</application>,
and <application>PHP</application> are supported by default. To
support another interpreter, set <varname>SHEBANG_LANG</varname>
(for example
<literal>SHEBANG_LANG=lua</literal>), then
(for example <literal>SHEBANG_LANG=lua</literal>), then
<varname>lua_OLD_CMD</varname> and
<varname>lua_CMD</varname>.</entry>
</row>
<row>
<entry><literal>twisted</literal></entry>
<entry>(none), <literal>ARGS</literal></entry>
<entry>Add a dependency on <application>twistedCore</application>.
The list of required components can be specified as a value of
this variable. <literal>ARGS</literal> can be one of:
this variable. <literal>ARGS</literal> can be one of:
<itemizedlist>
<listitem>
@ -403,68 +501,98 @@
Besides <literal>build</literal> and <literal>run</literal>, one
or more other supported <application>twisted</application>
components can be specified. Supported values are listed in
<filename>Uses/twisted.mk</filename>.
</entry>
<filename>Uses/twisted.mk</filename>.</entry>
</row>
<row>
<entry><literal>uidfix</literal></entry>
<entry>(none)</entry>
<entry>Changes some default behavior (mostly variables) of the build
system to allow installing this port as a normal user. Try this in
your port before adding <literal>NEED_ROOT=yes</literal></entry>
system to allow installing this port as a normal user. Try this
in your port before adding
<literal>NEED_ROOT=yes</literal></entry>
</row>
<row>
<entry><literal>webplugin</literal></entry>
<entry>(none), <literal>ARGS</literal></entry>
<entry>Automatically create and remove symbolic links for each
application that supports the webplugin framework.
<literal>ARGS</literal> can be one of:
<itemizedlist>
<listitem><para><literal>gecko</literal>: support plug-ins based
on Gecko</para></listitem>
<listitem><para><literal>native</literal>: support plug-ins for
Gecko, Opera, and WebKit-GTK</para></listitem>
<listitem><para><literal>linux</literal>: support Linux
plug-ins</para></listitem>
<listitem><para><literal>all</literal> (default, implicit):
support all plug-in types</para></listitem>
<listitem><para>(individual entries): support only the browsers
listed</para></listitem>
</itemizedlist>
The following variables can be adjusted:
<itemizedlist>
<listitem><para><varname>WEBPLUGIN_FILES</varname>: No default,
must be set manually. The plug-in files to
install.</para></listitem>
<listitem><para><varname>WEBPLUGIN_DIR</varname>: The directory
to install the plug-in files to, default <filename
class="directory"><replaceable>PREFIX</replaceable>/lib/browser_plugins/<replaceable>WEBPLUGIN_NAME</replaceable></filename>.
Set this if the port installs plug-in files outside of the
default directory to prevent broken symbolic
links.</para></listitem>
<listitem><para><varname>WEBPLUGIN_NAME</varname>: The final
directory to install the plug-in files into, default
<varname>PKGBASE</varname>.</para></listitem>
</itemizedlist></entry>
application that supports the webplugin framework.
<literal>ARGS</literal> can be one of:
<itemizedlist>
<listitem>
<para><literal>gecko</literal>: support plug-ins based
on Gecko</para>
</listitem>
<listitem>
<para><literal>native</literal>: support plug-ins for
Gecko, Opera, and WebKit-GTK</para>
</listitem>
<listitem>
<para><literal>linux</literal>: support Linux
plug-ins</para>
</listitem>
<listitem>
<para><literal>all</literal> (default, implicit):
support all plug-in types</para>
</listitem>
<listitem>
<para>(individual entries): support only the browsers
listed</para>
</listitem>
</itemizedlist>
The following variables can be adjusted:
<itemizedlist>
<listitem>
<para><varname>WEBPLUGIN_FILES</varname>: No default, must be
set manually. The plug-in files to install.</para>
</listitem>
<listitem>
<para><varname>WEBPLUGIN_DIR</varname>: The directory
to install the plug-in files to, default <filename
class="directory"><replaceable>PREFIX</replaceable>/lib/browser_plugins/<replaceable>WEBPLUGIN_NAME</replaceable></filename>.
Set this if the port installs plug-in files outside of the
default directory to prevent broken symbolic
links.</para>
</listitem>
<listitem>
<para><varname>WEBPLUGIN_NAME</varname>: The final
directory to install the plug-in files into, default
<varname>PKGBASE</varname>.</para>
</listitem>
</itemizedlist></entry>
</row>
<row>
<entry><literal>zenoss</literal></entry>
<entry>(none)</entry>
<entry>Implies the port uses
<package>net-mgmt/zenoss</package> in one way or
another, but largely is used for building zenoss related zenpack
ports.</entry>
<entry>Implies the port uses <package>net-mgmt/zenoss</package> in
one way or another, but largely is used for building zenoss
related zenpack ports.</entry>
</row>
<row>
<entry><literal>zope</literal></entry>
<entry>(none)</entry>
<entry>Implies that the port uses
<package>www/zope</package> in one way or another,
but is largely used for building zope related ports.
<varname>ZOPE_VERSION</varname> can be used by a port to indicate that
a specific version of zope shall be used.</entry>
<entry>Implies that the port uses <package>www/zope</package> in one
way or another, but is largely used for building zope related
ports. <varname>ZOPE_VERSION</varname> can be used by a port to
indicate that a specific version of zope shall be used.</entry>
</row>