5.7.8 USE_* section:
- Remove variables that are described later in Chapter 6 from the table - Add a paragraph with references to relevant Chapter 6 sections 5.14 Building mechanisms - Move this section into Chapter 6 and merge with Section 6.5 about autotools 6.5 Using automake, autoconf, and libtool - Move after Section 6.2 Ports with distribution restrictions - Rename to Building mechanisms - Integrate content from Section 5.14 and 5.7.8 - Split into subsections: * make, gmake, and imake: 5.7.8 text on gmake, 5.14 text on imake, ALL_TARGET * configure script: 5.14 text on configure, new text * autoconf: split old table from 6.5 and add some introductory text * automake: split old table from 6.5 and add some introductory text * libtool: split old table from 6.5, add text about what libtool is, mention USE_INC_LIBTOOL_VER, and interoperability problems with USE_GCC - Change section id from using-automake to using-autotools Approved by: keramida (mentor)
This commit is contained in:
parent
072909287d
commit
c4baeed91c
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=25569
1 changed files with 445 additions and 329 deletions
|
@ -3306,65 +3306,6 @@ PATCHFILES= patch1:test</programlisting>
|
|||
<command>zip</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_GMAKE</makevar></entry>
|
||||
|
||||
<entry>The port requires <command>gmake</command> to
|
||||
build.</entry>
|
||||
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_PERL5</makevar></entry>
|
||||
|
||||
<entry>The port requires <literal>perl 5</literal> to build and install. See
|
||||
<xref linkend="using-perl"> for additional variables that
|
||||
can be set relating to <literal>perl</literal>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_X_PREFIX</makevar></entry>
|
||||
|
||||
<entry>The port installs in to <makevar>X11BASE</makevar>
|
||||
rather than <makevar>PREFIX</makevar>. See
|
||||
<xref linkend="using-x11"> for additional variables that
|
||||
can be set relating to X11.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOMAKE_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses GNU <command>automake</command> as part
|
||||
of its build process. See <xref linkend="using-automake">
|
||||
for additional variables that can be set relating to
|
||||
<command>automake</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOCONF_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses GNU <command>autoconf</command> as part
|
||||
of its build process. See <xref linkend="using-automake">
|
||||
for additional variables that can be set relating to
|
||||
<command>autoconf</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_LIBTOOL_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses GNU <command>libtool</command> as part of
|
||||
its build process. See <xref linkend="using-automake"> for
|
||||
additional variables that can be set relating to
|
||||
<command>libtool</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>GMAKE</makevar></entry>
|
||||
|
||||
<entry>The full path for <command>gmake</command> if it is not
|
||||
in the <envar>PATH</envar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_BISON</makevar></entry>
|
||||
|
||||
|
@ -3373,15 +3314,7 @@ PATCHFILES= patch1:test</programlisting>
|
|||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_SDL</makevar></entry>
|
||||
|
||||
<entry>The port uses <literal>SDL</literal> for
|
||||
building and running. See <xref linkend="using-sdl"> on how to use
|
||||
<makevar>USE_SDL</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_GCC</makevar></entry>
|
||||
<entry><makevar>USE_GCC</makevar></entry>
|
||||
|
||||
<entry>The port requires a specific version of
|
||||
<command>gcc</command> to build. The exact version can be
|
||||
|
@ -3396,28 +3329,29 @@ PATCHFILES= patch1:test</programlisting>
|
|||
<makevar>USE_LIBTOOL_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>NO_INSTALL_MANPAGES</makevar></entry>
|
||||
|
||||
<entry>Do not use the <maketarget>install.man</maketarget>
|
||||
target.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<para>Define <literal>USE_XLIB=yes</literal> if your port requires
|
||||
the X Window System to be installed (it is implied by
|
||||
<makevar>USE_IMAKE</makevar>). Define
|
||||
<literal>USE_GMAKE=yes</literal> if your port requires GNU
|
||||
<command>make</command> instead of BSD <command>make</command>.
|
||||
Define <literal>USE_AUTOCONF_VER=213</literal> if your port requires
|
||||
GNU autoconf to be run. Define <literal>USE_QT_VER=3</literal> if
|
||||
your port uses the latest Qt toolkit. Use
|
||||
<literal>USE_PERL5=yes</literal> if your port requires version 5
|
||||
of the <literal>perl</literal> language. (The last is especially important since
|
||||
some versions of FreeBSD have <literal>perl5</literal> as part of the base system
|
||||
while others do not.)</para>
|
||||
<para>Variables related to <application>gmake</application>,
|
||||
<filename>configure</filename> script,
|
||||
<application>autoconf</application>,
|
||||
<application>automake</application> and
|
||||
<application>libtool</application> are described in
|
||||
<xref linkend="using-autotools">. <application>Perl</application>
|
||||
related variables are described in <xref linkend="using-perl">.
|
||||
X11 variables are listed in <xref linkend="using-x11">. <xref
|
||||
linkend="using-gnome"> deals with GNOME and <xref
|
||||
linkend="using-kde"> with KDE related variables. <xref
|
||||
linkend="using-java"> documents Java variables, while <xref
|
||||
linkend="using-php"> contains information on
|
||||
<application>Apache</application>, <application>PHP</application>
|
||||
and PEAR modules. <application>Python</application> is discussed
|
||||
in <xref linkend="using-python">, while
|
||||
<application>Ruby</application> in <xref linkend="using-ruby">.
|
||||
Finally, <xref linkend="using-sdl"> provides variables used for
|
||||
<application>SDL</application> applications.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
|
@ -3906,63 +3840,6 @@ PORTVERSION= 1.0</programlisting>
|
|||
</note>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="makefile-build">
|
||||
<title>Building mechanisms</title>
|
||||
|
||||
<para>If your package uses GNU <command>make</command>, set
|
||||
<literal>USE_GMAKE=yes</literal>. If your package uses
|
||||
<command>configure</command>, set
|
||||
<literal>HAS_CONFIGURE=yes</literal>. If your package uses GNU
|
||||
<command>configure</command>, set
|
||||
<literal>GNU_CONFIGURE=yes</literal> (this implies
|
||||
<literal>HAS_CONFIGURE</literal>). If you want to give some extra
|
||||
arguments to <command>configure</command> (the default argument list
|
||||
<literal>--prefix=${PREFIX}</literal> for GNU
|
||||
<command>configure</command> and empty for non-GNU
|
||||
<command>configure</command>), set those extra arguments in
|
||||
<makevar>CONFIGURE_ARGS</makevar>. If your package uses GNU
|
||||
<command>autoconf</command>, set
|
||||
<literal>USE_AUTOCONF_VER=213</literal>. This implies
|
||||
<makevar>GNU_CONFIGURE</makevar>, and will cause
|
||||
<command>autoconf</command> to be run before
|
||||
<command>configure</command>.</para>
|
||||
|
||||
<note>
|
||||
<para>If your package uses GNU <command>configure</command>, and
|
||||
the resulting executable file has a <quote>strange</quote> name
|
||||
like
|
||||
<filename>i386-portbld-freebsd4.7-</filename><replaceable>appname</replaceable>,
|
||||
you will need to additionally override the
|
||||
<makevar>CONFIGURE_TARGET</makevar> variable to specify the
|
||||
target in the way required by scripts generated by recent
|
||||
versions of <command>autoconf</command>. Add the following line
|
||||
immediately after the <literal>GNU_CONFIGURE=yes</literal> line
|
||||
in your <filename>Makefile</filename>:</para>
|
||||
|
||||
<para>
|
||||
<literal>CONFIGURE_TARGET=--build=${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal>
|
||||
</para>
|
||||
</note>
|
||||
|
||||
<para>If your package is an X application that creates
|
||||
<filename>Makefile</filename>s from <filename>Imakefile</filename>s
|
||||
using <command>imake</command>, then set
|
||||
<literal>USE_IMAKE=yes</literal>. This will cause the configure
|
||||
stage to automatically do an <command>xmkmf -a</command>. If the
|
||||
<option>-a</option> flag is a problem for your port, set
|
||||
<literal>XMKMF=xmkmf</literal>. If the port uses
|
||||
<command>imake</command> but does not understand the
|
||||
<maketarget>install.man</maketarget> target,
|
||||
<literal>NO_INSTALL_MANPAGES=yes</literal> should be set. In
|
||||
addition, the author of the original port should be shot. <!--
|
||||
smiley --><emphasis>:-></emphasis></para>
|
||||
|
||||
<para>If your port's source <filename>Makefile</filename> has
|
||||
something else than <maketarget>all</maketarget> as the main build
|
||||
target, set <makevar>ALL_TARGET</makevar> accordingly. Same goes
|
||||
for <maketarget>install</maketarget> and
|
||||
<makevar>INSTALL_TARGET</makevar>.</para>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<chapter id="special">
|
||||
|
@ -4110,6 +3987,430 @@ LDCONFIG_DIRS= %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
|
|||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="using-autotools">
|
||||
<title>Building mechanisms</title>
|
||||
|
||||
<sect2 id="using-make">
|
||||
<title><command>make</command>, <command>gmake</command>, and
|
||||
<command>imake</command></title>
|
||||
|
||||
<para>If your port uses <application>GNU make</application>, set
|
||||
<literal>USE_GMAKE=yes</literal>.</para>
|
||||
|
||||
<table frame="none">
|
||||
<title>Variables for ports related to gmake</title>
|
||||
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Variable</entry>
|
||||
|
||||
<entry>Means</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><makevar>USE_GMAKE</makevar></entry>
|
||||
|
||||
<entry>The port requires <command>gmake</command> to
|
||||
build.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>GMAKE</makevar></entry>
|
||||
|
||||
<entry>The full path for <command>gmake</command> if it is not
|
||||
in the <envar>PATH</envar>.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<para>If your port is an X application that creates
|
||||
<filename>Makefile</filename> files from
|
||||
<filename>Imakefile</filename> files using
|
||||
<application>imake</application>, then set
|
||||
<literal>USE_IMAKE=yes</literal>. This will cause the
|
||||
configure stage to automatically do an <command>xmkmf -a</command>.
|
||||
If the <option>-a</option> flag is a problem for your port, set
|
||||
<literal>XMKMF=xmkmf</literal>. If the port uses
|
||||
<application>imake</application> but does not understand the
|
||||
<maketarget>install.man</maketarget> target,
|
||||
<literal>NO_INSTALL_MANPAGES=yes</literal> should be set.</para>
|
||||
|
||||
<para>If your port's source <filename>Makefile</filename> has
|
||||
something else than <maketarget>all</maketarget> as the main build
|
||||
target, set <makevar>ALL_TARGET</makevar> accordingly. Same goes
|
||||
for <maketarget>install</maketarget> and
|
||||
<makevar>INSTALL_TARGET</makevar>.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2 id="using-configure">
|
||||
<title><command>configure</command> script</title>
|
||||
|
||||
<para>If your port uses the <command>configure</command> script to
|
||||
generate <filename>Makefile</filename> files from
|
||||
<filename>Makefile.in</filename> files, set
|
||||
<literal>GNU_CONFIGURE=yes</literal>. If you want to give extra
|
||||
arguments to the <command>configure</command> script (the default
|
||||
argument is <literal>--prefix=${PREFIX}
|
||||
${CONFIGURE_TARGET}</literal>), set those
|
||||
extra arguments in <makevar>CONFIGURE_ARGS</makevar>. Extra
|
||||
environment variables can be passed using
|
||||
<makevar>CONFIGURE_ENV</makevar> variable.</para>
|
||||
|
||||
<para>If your package uses GNU <command>configure</command>, and
|
||||
the resulting executable file has a <quote>strange</quote> name
|
||||
like
|
||||
<filename>i386-portbld-freebsd4.7-</filename><replaceable>appname</replaceable>,
|
||||
you will need to additionally override the
|
||||
<makevar>CONFIGURE_TARGET</makevar> variable to specify the
|
||||
target in the way required by scripts generated by recent
|
||||
versions of <command>autoconf</command>. Add the following line
|
||||
immediately after the <literal>GNU_CONFIGURE=yes</literal> line
|
||||
in your <filename>Makefile</filename>:</para>
|
||||
|
||||
<para>
|
||||
<literal>CONFIGURE_TARGET=--build=${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal>
|
||||
</para>
|
||||
|
||||
<table frame="none">
|
||||
<title>Variables for ports that use configure</title>
|
||||
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Variable</entry>
|
||||
|
||||
<entry>Means</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><makevar>GNU_CONFIGURE</makevar></entry>
|
||||
|
||||
<entry>The port uses <command>configure</command> script to
|
||||
prepare build.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>HAS_CONFIGURE</makevar></entry>
|
||||
|
||||
<entry>Same as <makevar>GNU_CONFIGURE</makevar>, except
|
||||
default configure target is not added to
|
||||
<makevar>CONFIGURE_ARGS</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>CONFIGURE_ARGS</makevar></entry>
|
||||
|
||||
<entry>Additional arguments passed to
|
||||
<command>configure</command> script.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>CONFIGURE_ENV</makevar></entry>
|
||||
|
||||
<entry>Additional environment variables to be set
|
||||
for <command>configure</command> script run.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>CONFIGURE_TARGET</makevar></entry>
|
||||
|
||||
<entry>Override default configure target. Default value is
|
||||
<literal>${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal>.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="using-autoconf">
|
||||
<title><command>autoconf</command></title>
|
||||
|
||||
<para>Some ports do not contain a <filename>configure</filename>
|
||||
script, but do contain an <application>autoconf</application> template
|
||||
in the <filename>configure.ac</filename> file. You can use
|
||||
<makevar>USE_AUTOCONF_VER</makevar> variable to let
|
||||
<application>autoconf</application> create
|
||||
the <filename>configure</filename> script. It is also useful for
|
||||
recreating the <filename>configure</filename> script after patching
|
||||
<filename>configure.ac</filename>.</para>
|
||||
|
||||
<table frame="none">
|
||||
<title>Variables for ports that use autoconf</title>
|
||||
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Variable</entry>
|
||||
|
||||
<entry>Means</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOCONF_VER</makevar></entry>
|
||||
|
||||
<entry>Specifies that the port uses <command>autoconf</command>.
|
||||
Implies <literal>GNU_CONFIGURE</literal>. Valid values are
|
||||
<literal>213</literal>, <literal>253</literal>, and
|
||||
<literal>259</literal>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOCONF</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoconf</command> if it
|
||||
is not in the <envar>PATH</envar>. The default is set
|
||||
according to the <makevar>USE_AUTOCONF_VER</makevar>
|
||||
variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOCONF_ARGS</makevar></entry>
|
||||
|
||||
<entry>Command line arguments to pass to
|
||||
<command>autoconf</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOCONF_ENV</makevar></entry>
|
||||
|
||||
<entry>Set these
|
||||
<literal><replaceable>variable</replaceable>=<replaceable>value</replaceable></literal>
|
||||
pairs in the environment before running
|
||||
<command>autoconf</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOHEADER_VER</makevar></entry>
|
||||
|
||||
<entry>Specifies that the port uses <command>autoheader</command>.
|
||||
Implies <literal>USE_AUTOCONF_VER</literal>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOHEADER</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoheader</command> if
|
||||
it is not in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTORECONF</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoreconf</command> if
|
||||
it is not in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOSCAN</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoscan</command> if it
|
||||
is not set in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOIFNAMES</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoifnames</command> if
|
||||
it is not set in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="using-automake">
|
||||
<title><command>automake</command></title>
|
||||
|
||||
<para>Some packages only contain <filename>Makefile.am</filename>
|
||||
files. These have to be converted into
|
||||
<filename>Makefile.in</filename> files using
|
||||
<application>automake</application>. Specify the
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> variable.</para>
|
||||
|
||||
<table frame="none">
|
||||
<title>Variables for ports that use automake</title>
|
||||
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Variable</entry>
|
||||
|
||||
<entry>Means</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE</makevar></entry>
|
||||
|
||||
<entry>The full path for <command>automake</command>, if it is
|
||||
not in the <envar>PATH</envar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOMAKE_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses <command>automake</command>. Valid values
|
||||
for this variable are <literal>14</literal>,
|
||||
<literal>15</literal>, and <literal>19</literal>, and sets
|
||||
the <makevar>AUTOMAKE_DIR</makevar> and
|
||||
<makevar>ACLOCAL_DIR</makevar> variables
|
||||
appropriately.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE_ARGS</makevar></entry>
|
||||
|
||||
<entry>One or more command line arguments to pass to
|
||||
<makevar>AUTOMAKE</makevar> if
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> is set.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE_ENV</makevar></entry>
|
||||
|
||||
<entry>One or more environment variables to set (and their
|
||||
values) before running <makevar>AUTOMAKE</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>ACLOCAL</makevar></entry>
|
||||
|
||||
<entry>Set to the path of the GNU <command>aclocal</command> if
|
||||
it is not in the <envar>PATH</envar>. The default is set
|
||||
according to the <makevar>USE_AUTOMAKE_VER</makevar>
|
||||
variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>ACLOCAL_DIR</makevar></entry>
|
||||
|
||||
<entry>Set to the path of the GNU <command>aclocal</command>
|
||||
shared directory. The default is set according to the
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE_DIR</makevar></entry>
|
||||
|
||||
<entry>Set to the path of the GNU <command>automake</command>
|
||||
shared directory. The default is set according to the
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> variable.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
</sect2>
|
||||
<sect2 id="using-libtool">
|
||||
<title><command>libtool</command></title>
|
||||
|
||||
<para>Shared libraries using the GNU building framework usually use
|
||||
<application>libtool</application> to adjust the compilation
|
||||
and installation of shared library to match the customs of given
|
||||
operating system. The Ports Collection provides a version
|
||||
of <application>libtool</application> modified for &os;. Changes
|
||||
include suppressing of minor version numbers in names of installed
|
||||
files, and prevention of <filename>*.la</filename> (libtool archive)
|
||||
files installation.</para>
|
||||
|
||||
<para>To replace copy of <application>libtool</application> included
|
||||
in the port with our modified copy, specify
|
||||
<makevar>USE_LIBTOOL_VER</makevar> variable. If, for any reason,
|
||||
our modified <application>libtool</application> does not work,
|
||||
omit any <application>libtool</application> related variables
|
||||
to use bundled copy of <application>libtool</application>.</para>
|
||||
|
||||
<table frame="none">
|
||||
<title>Variables for ports that use libtool</title>
|
||||
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Variable</entry>
|
||||
|
||||
<entry>Means</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><makevar>USE_LIBTOOL_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses <command>libtool</command>. Implies
|
||||
<makevar>GNU_CONFIGURE</makevar>.
|
||||
The <filename>configure</filename> script will be patched
|
||||
to use system copy of <command>libtool</command>.
|
||||
Valid values are <literal>13</literal> and
|
||||
<literal>15</literal>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_INC_LIBTOOL_VER</makevar></entry>
|
||||
|
||||
<entry>Same as <makevar>USE_LIBTOOL_VER</makevar>, except
|
||||
the <filename>configure</filename> patching will not be
|
||||
performed. You must take care of it yourself.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>LIBTOOL</makevar></entry>
|
||||
|
||||
<entry>Set to the path of <command>libtool</command> if it is
|
||||
not set in the <envar>PATH</envar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>LIBTOOLFILES</makevar></entry>
|
||||
|
||||
<entry>The files to patch for <command>libtool</command>.
|
||||
Defaults to <literal>aclocal.m4</literal> if
|
||||
<makevar>USE_AUTOCONF</makevar> is defined,
|
||||
<literal>configure</literal> otherwise.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>LIBTOOLFLAGS</makevar></entry>
|
||||
|
||||
<entry>Additional flags to pass to
|
||||
<command>ltconfig</command>. Defaults to
|
||||
<literal>--disable-ltlibs</literal>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_LIBLTDL</makevar></entry>
|
||||
|
||||
<entry>The port uses <command>libltdl</command>.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<note>
|
||||
<para><makevar>USE_LIBTOOL_VER</makevar> does not work together
|
||||
with <makevar>USE_GCC</makevar>. You have to use
|
||||
<makevar>USE_INC_LIBTOOL_VER</makevar> and perform manual patching.
|
||||
Look at <literal>patch-autotools</literal> target in
|
||||
<filename role="package">devel/glibmm</filename>
|
||||
for an example.</para>
|
||||
</note>
|
||||
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="using-perl">
|
||||
<title>Using <literal>perl</literal></title>
|
||||
|
||||
|
@ -4444,191 +4745,6 @@ USE_XLIB= yes</programlisting>
|
|||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="using-automake">
|
||||
<title>Using <command>automake</command>, <command>autoconf</command>,
|
||||
and <command>libtool</command></title>
|
||||
|
||||
<table frame="none">
|
||||
<title>Variables for ports that use automake, autoconf or
|
||||
libtool</title>
|
||||
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Variable</entry>
|
||||
|
||||
<entry>Means</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE</makevar></entry>
|
||||
|
||||
<entry>The full path for <command>automake</command> if it is
|
||||
not in the <envar>PATH</envar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOMAKE_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses <command>automake</command>. Valid values
|
||||
for this variable are <literal>14</literal> and
|
||||
<literal>15</literal>, and sets the
|
||||
<makevar>AUTOMAKE_DIR</makevar> and
|
||||
<makevar>ACLOCAL_DIR</makevar> variables
|
||||
appropriately.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE_ARGS</makevar></entry>
|
||||
|
||||
<entry>One or more command line arguments to pass to
|
||||
<makevar>AUTOMAKE</makevar> if
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> is set.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE_ENV</makevar></entry>
|
||||
|
||||
<entry>One or more environment variables to set (and their
|
||||
values) before running <makevar>AUTOMAKE</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>ACLOCAL</makevar></entry>
|
||||
|
||||
<entry>Set to the path of the GNU <command>aclocal</command> if
|
||||
it is not in the <envar>PATH</envar>. The default is set
|
||||
according to the <makevar>USE_AUTOMAKE_VER</makevar>
|
||||
variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>ACLOCAL_DIR</makevar></entry>
|
||||
|
||||
<entry>Set to the path of the GNU <command>aclocal</command>
|
||||
shared directory. The default is set according to the
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOMAKE_DIR</makevar></entry>
|
||||
|
||||
<entry>Set to the path of the GNU <command>automake</command>
|
||||
shared directory. The default is set according to the
|
||||
<makevar>USE_AUTOMAKE_VER</makevar> variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOCONF_VER</makevar></entry>
|
||||
|
||||
<entry>Specifies that the port uses <command>autoconf</command>.
|
||||
Implies <literal>GNU_CONFIGURE</literal>.
|
||||
The default value is 213.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOCONF</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoconf</command> if it
|
||||
is not in the <envar>PATH</envar>. The default is set
|
||||
according to the <makevar>USE_AUTOCONF_VER</makevar>
|
||||
variable.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOCONF_ARGS</makevar></entry>
|
||||
|
||||
<entry>Command line arguments to pass to
|
||||
<command>autoconf</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOCONF_ENV</makevar></entry>
|
||||
|
||||
<entry>Set these
|
||||
<literal><replaceable>variable</replaceable>=<replaceable>value</replaceable></literal>
|
||||
pairs in the environment before running
|
||||
<command>autoconf</command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_AUTOHEADER_VER</makevar></entry>
|
||||
|
||||
<entry>Specifies that the port uses <command>autoheader</command>.
|
||||
Implies <literal>USE_AUTOCONF_VER</literal>.
|
||||
The default value is 213.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOHEADER</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoheader</command> if
|
||||
it is not in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTORECONF</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoreconf</command> if
|
||||
it is not in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOSCAN</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoscan</command> if it
|
||||
is not set in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>AUTOIFNAMES</makevar></entry>
|
||||
|
||||
<entry>Set to the path of GNU <command>autoifnames</command> if
|
||||
it is not set in the <envar>PATH</envar>. The default is set
|
||||
according to <makevar>USE_AUTOCONF_VER</makevar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>USE_LIBTOOL_VER</makevar></entry>
|
||||
|
||||
<entry>The port uses <command>libtool</command>. Implies
|
||||
<makevar>GNU_CONFIGURE</makevar>.
|
||||
The default value is 13.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>LIBTOOL</makevar></entry>
|
||||
|
||||
<entry>Set to the path of <command>libtool</command> if it is
|
||||
not set in the <envar>PATH</envar>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>LIBTOOLFILES</makevar></entry>
|
||||
|
||||
<entry>The files to patch for <command>libtool</command>.
|
||||
Defaults to <literal>aclocal.m4</literal> if
|
||||
<makevar>USE_AUTOCONF</makevar> is defined,
|
||||
<literal>configure</literal> otherwise.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><makevar>LIBTOOLFLAGS</makevar></entry>
|
||||
|
||||
<entry>Additional flags to pass to
|
||||
<command>ltconfig</command>. Defaults to
|
||||
<literal>--disable-ltlibs</literal>.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="using-gnome">
|
||||
<title>Using GNOME</title>
|
||||
|
||||
|
@ -5000,7 +5116,7 @@ USE_XLIB= yes</programlisting>
|
|||
runs Ant according to <makevar>MAKE_ENV</makevar>,
|
||||
<makevar>MAKE_ARGS</makevar> and <makevar>ALL_TARGETS</makevar>.
|
||||
This is similar to the <makevar>USE_GMAKE</makevar> mechanism,
|
||||
which is documented in <xref linkend="makefile-build">.</para>
|
||||
which is documented in <xref linkend="using-autotools">.</para>
|
||||
|
||||
<para>If <command>jikes</command> is used in place of
|
||||
<command>javac</command> (see <makevar>USE_JIKES</makevar> in
|
||||
|
|
Loading…
Reference in a new issue