From owner-svn-doc-head@freebsd.org Tue Mar 20 11:16:06 2018 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id DD1F7F68E09; Tue, 20 Mar 2018 11:16:05 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 6F8816DB5C; Tue, 20 Mar 2018 11:16:05 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4B2691C2EF; Tue, 20 Mar 2018 11:16:05 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w2KBG5T8059052; Tue, 20 Mar 2018 11:16:05 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w2KBG5DA059050; Tue, 20 Mar 2018 11:16:05 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201803201116.w2KBG5DA059050@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Tue, 20 Mar 2018 11:16:05 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51510 - in head/en_US.ISO8859-1/books/porters-handbook: slow-porting special X-SVN-Group: doc-head X-SVN-Commit-Author: mat X-SVN-Commit-Paths: in head/en_US.ISO8859-1/books/porters-handbook: slow-porting special X-SVN-Commit-Revision: 51510 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Mar 2018 11:16:06 -0000 Author: mat Date: Tue Mar 20 11:16:04 2018 New Revision: 51510 URL: https://svnweb.freebsd.org/changeset/doc/51510 Log: USE_AUTOTOOLS was retired. Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml Tue Mar 20 10:39:21 2018 (r51509) +++ head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml Tue Mar 20 11:16:04 2018 (r51510) @@ -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. Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Tue Mar 20 10:39:21 2018 (r51509) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Tue Mar 20 11:16:04 2018 (r51510) @@ -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.