Update porters handbook to sync to new autotools world order:

* remove warning that the versions cannot be used for cross-development
  outside of the ports tree, this is no longer true

* add reference to the 'autotools' USE_AUTOTOOLS construct (for ports)
  and ports/devel/autotools to bring in all available versions of
  autotools

* remove table mapping old constructs to USE_AUTOTOOLS stanzas, since
  they haven't been present for a long time.

Reviewed by:	pav
This commit is contained in:
Ade Lovett 2007-07-28 21:26:57 +00:00
parent d0912c014b
commit 036be48428
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=30535

View file

@ -4761,14 +4761,11 @@ PORTVERSION= 1.0</programlisting>
them all on a single line, or using the <literal>+=</literal>
Makefile construct.</para>
<para>Before proceeding any further, it cannot be stressed highly
enough that the constructs discussed here are for use ONLY in
building other ports. For cross-development work, the
<literal>devel/gnu-{automake,autoconf,libtool}</literal> ports
should be used, such as within an IDE. <filename
role="package">devel/anjuta</filename> and <filename
role="package">devel/kdevelop</filename> (GNOME and KDE
respectively) are good examples of how to achieve this.</para>
<para>Finally, there is the special tool, called
<literal>autotools</literal>, which is a convenience function
to bring in all available versions of the autotools to allow
for cross-development work. This can also be accomplished
by installing the <literal>devel/autotools</literal> port.
</sect2>
@ -4797,39 +4794,6 @@ PORTVERSION= 1.0</programlisting>
<para>With the <literal>:env</literal> operation, only the
environment will be set up.</para>
<informaltable frame="none">
<tgroup cols="2">
<thead>
<row>
<entry>Previously</entry>
<entry><makevar>USE_AUTOTOOLS</makevar> construct</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>USE_LIBTOOL_VER=15</literal></entry>
<entry><literal>libtool:15</literal></entry>
</row>
<row>
<entry><literal>USE_INC_LIBTOOL_VER=15</literal></entry>
<entry>not in use anymore</entry>
</row>
<row>
<entry><literal>WANT_LIBTOOL_VER=15</literal></entry>
<entry><literal>libtool:15:env</literal></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>Finally, <makevar>LIBTOOLFLAGS</makevar> and
<makevar>LIBTOOLFILES</makevar> can be optionally set to override
the most likely arguments to, and files patched by,
@ -4857,27 +4821,6 @@ PORTVERSION= 1.0</programlisting>
outside of the <makevar>USE_AUTOTOOLS</makevar> framework. There
are no optional operations for this tool.</para>
<informaltable frame="none">
<tgroup cols="2">
<thead>
<row>
<entry>Previously</entry>
<entry><makevar>USE_AUTOTOOLS</makevar> construct</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>USE_LIBLTDL=YES</literal></entry>
<entry><literal>libltdl:15</literal></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>
<sect2 id="using-autoconf">
@ -4905,40 +4848,6 @@ PORTVERSION= 1.0</programlisting>
environment for further use. Without it, patching and
reconfiguration of the port is carried out.</para>
<informaltable frame="none">
<tgroup cols="2">
<thead>
<row>
<entry>Previously</entry>
<entry><makevar>USE_AUTOTOOLS</makevar> construct</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>USE_AUTOCONF_VER=213</literal></entry>
<entry><literal>autoconf:213</literal></entry>
</row>
<row>
<entry><literal>WANT_AUTOCONF_VER=259</literal></entry>
<entry><literal>autoconf:259:env</literal></entry>
</row>
<row>
<entry><literal>USE_AUTOHEADER_VER=253</literal></entry>
<entry><literal>autoheader:253</literal> (implies
<literal>autoconf:253</literal>)</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>The additional optional variables
<makevar>AUTOCONF_ARGS</makevar> and
<makevar>AUTOHEADER_ARGS</makevar> can be overridden by the port
@ -4986,40 +4895,6 @@ PORTVERSION= 1.0</programlisting>
for further use. Without it, reconfiguration of the port is
carried out.</para>
<informaltable frame="none">
<tgroup cols="2">
<thead>
<row>
<entry>Previously</entry>
<entry><makevar>USE_AUTOTOOLS</makevar> construct</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>USE_AUTOMAKE_VER=14</literal></entry>
<entry><literal>automake:14</literal></entry>
</row>
<row>
<entry><literal>WANT_AUTOMAKE_VER=15</literal></entry>
<entry><literal>automake:15:env</literal></entry>
</row>
<row>
<entry><literal>USE_ACLOCAL_VER=19</literal></entry>
<entry><literal>aclocal:19</literal> (implies
<literal>automake:19</literal>)</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>As with
<command>autoconf</command> and <command>autoheader</command>, both
<command>automake</command> and <command>aclocal</command> have