From 0dc27bbf87f9985474fcd711b14b7a11941ec48d Mon Sep 17 00:00:00 2001 From: Mathieu Arnold Date: Tue, 20 Mar 2018 11:16:04 +0000 Subject: [PATCH] USE_AUTOTOOLS was retired. Sponsored by: Absolight --- .../porters-handbook/slow-porting/chapter.xml | 2 +- .../porters-handbook/special/chapter.xml | 132 +----------------- 2 files changed, 4 insertions(+), 130 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml index de1227ac82..16101f0cc7 100644 --- a/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml +++ b/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml @@ -394,7 +394,7 @@ configure, do not take the diffs of configure (it often grows to a few thousand lines!). Instead, define - USE_AUTOTOOLS=autoconf:261 and take the + USES=autoreconf and take the diffs of configure.in. diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml index 4eec24fc9c..d71ce80aa5 100644 --- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml +++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml @@ -827,135 +827,9 @@ CMAKE_OFF= VAR3 Using GNU Autotools - - Introduction - - The various GNU autotools provide an abstraction - mechanism for building a piece of software over a wide - variety of operating systems and machine architectures. - Within the Ports Collection, an individual port can make use - of these tools via a simple construct: - - USE_AUTOTOOLS= tool[:env] ... - - At the time of writing, tool - can be one of autoconf, - autoheader, automake, - aclocal, libtoolize. - It can also be one the older - legacy of autoconf213, - autoheader213, - automake14, - aclocal14. - - env is used to specify that the - environmental variables are needed. It also adds a build - dependency on the tool. The relevant tool is - not ran as part of the - run-autotools target. - - Multiple tools can be specified at once, either by - including them all on a single line, or using the - += Makefile construct. - - - - <command>libtool</command> and - <command>libtoolize</command> - - Ports shipping with their own copy of libtool (search for - a file named ltmain.sh) need to have - USES=libtool. If a port has - USE_AUTOTOOLS=libtoolize it probably also - needs USES=libtool. See the USES=libtool section in for more details. - - - - - <filename>libltdl.so</filename> - - Some ports make use of the libltdl.so - library package, which is part of the - libtool suite. Use of this library does - not automatically necessitate the use of - libtool itself. If the port needs - libltdl.so, add a dependency on - it: - - LIB_DEPENDS= libltdl.so:devel/libltdl - - - - <command>autoconf</command> and - <command>autoheader</command> - - Some ports do not contain a configure script, but do - contain an autoconf template in - configure.ac. Use these - assignments to let autoconf - create the configure script, and also have - autoheader create template headers for - use by the configure script. - - USE_AUTOTOOLS= autoconf[:env] - - and - - USE_AUTOTOOLS= autoheader - - which also implies the use of - autoconf. - - The additional optional variables - AUTOCONF_ARGS and - AUTOHEADER_ARGS can be overridden by the - port Makefile if specifically - requested. Most ports are unlikely to need this. See - bsd.autotools.mk for further - details. - - - - <command>automake</command> and - <command>aclocal</command> - - Some packages only contain - Makefile.am. These have to be - converted into Makefile.in using - automake, and the further processed by - configure to generate an actual - Makefile. - - Similarly, packages occasionally do not ship with - an included aclocal.m4, again - required to build the software. This can be achieved with - aclocal, which scans - configure.ac or - configure.in. - - aclocal has a similar relationship to - automake as autoheader - does to autoconf, described in the - previous section. aclocal implies the - use of automake, thus we have: - - USE_AUTOTOOLS= automake[:env] - - and - - USE_AUTOTOOLS= aclocal - - As with autoconf and - autoheader, both - automake and aclocal - have optional argument variables, - AUTOMAKE_ARGS and - ACLOCAL_ARGS respectively, which may be - overridden by the port Makefile if - required. - + If a port needs any of the GNU Autotools software, add + USES=autoreconf. See for more information.