From owner-svn-ports-head@freebsd.org Mon Jan 14 17:01:24 2019 Return-Path: Delivered-To: svn-ports-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 4604F14A642C; Mon, 14 Jan 2019 17:01:24 +0000 (UTC) (envelope-from tijl@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id D13446BB1D; Mon, 14 Jan 2019 17:01:23 +0000 (UTC) (envelope-from tijl@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 C2AFD5C2F; Mon, 14 Jan 2019 17:01:23 +0000 (UTC) (envelope-from tijl@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id x0EH1NI1074669; Mon, 14 Jan 2019 17:01:23 GMT (envelope-from tijl@FreeBSD.org) Received: (from tijl@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id x0EH1N9H074668; Mon, 14 Jan 2019 17:01:23 GMT (envelope-from tijl@FreeBSD.org) Message-Id: <201901141701.x0EH1N9H074668@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: tijl set sender to tijl@FreeBSD.org using -f From: Tijl Coosemans Date: Mon, 14 Jan 2019 17:01:23 +0000 (UTC) To: ports-committers@freebsd.org, svn-ports-all@freebsd.org, svn-ports-head@freebsd.org Subject: svn commit: r490303 - head/Mk/Uses X-SVN-Group: ports-head X-SVN-Commit-Author: tijl X-SVN-Commit-Paths: head/Mk/Uses X-SVN-Commit-Revision: 490303 X-SVN-Commit-Repository: ports MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: D13446BB1D X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-2.97 / 15.00]; local_wl_from(0.00)[FreeBSD.org]; NEURAL_HAM_MEDIUM(-1.00)[-0.999,0]; NEURAL_HAM_SHORT(-0.97)[-0.969,0]; ASN(0.00)[asn:11403, ipnet:2610:1c1:1::/48, country:US]; NEURAL_HAM_LONG(-1.00)[-0.999,0] X-BeenThere: svn-ports-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the ports tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 Jan 2019 17:01:24 -0000 Author: tijl Date: Mon Jan 14 17:01:23 2019 New Revision: 490303 URL: https://svnweb.freebsd.org/changeset/ports/490303 Log: Improve autoreconf documentation. Clarify that autopoint and libtoolize are provided by devel/gettext-tools and devel/libtool respectively and that a build dependency on these ports is necessary if autoreconf wants to run them. PR: 234833 Modified: head/Mk/Uses/autoreconf.mk Modified: head/Mk/Uses/autoreconf.mk ============================================================================== --- head/Mk/Uses/autoreconf.mk Mon Jan 14 16:41:59 2019 (r490302) +++ head/Mk/Uses/autoreconf.mk Mon Jan 14 17:01:23 2019 (r490303) @@ -3,46 +3,48 @@ # Run autoreconf in AUTORECONF_WRKSRC to update configure, Makefile.in and # other build scripts. # -# Autoreconf encapsulates the following commands. Each command applies to a -# single configure.ac or configure.in (old name). If configure.ac defines -# subdirectories with their own configure.ac (using AC_CONFIG_SUBDIRS), -# autoreconf will recursively update those as well. +# Autoreconf runs the following commands provided by devel/autoconf and +# devel/automake. Each command applies to a single configure.ac or +# configure.in (old name). If configure.ac defines subdirectories with their +# own configure.ac (using AC_CONFIG_SUBDIRS), autoreconf will recursively +# update those as well. # # aclocal Looks up definitions of m4 macros used in configure.ac that are # not provided by autoconf and copies them from their source *.m4 # file to aclocal.m4. Local *.m4 files included with the source # code take precedence over systemwide *.m4 files. -# Must be run whenever configure.ac or *.m4 files with macros -# used in configure.ac have been modified. -# Must also be run whenever automake must be run because the -# automake macros in aclocal.m4 must have the same version as the -# automake command. # autoconf Generates configure from configure.ac using macro definitions # provided by autoconf itself and aclocal.m4. -# Must be run whenever configure.ac or aclocal.m4 has been -# modified. # autoheader Generates a configuration header (typically config.h.in) from -# configure.ac and the macro definitions in aclocal.m4. -# Must be run whenever configure.ac or aclocal.m4 has been -# modified and configure.ac (or one of the macros it uses) -# contains AC_CONFIG_HEADERS, AC_CONFIG_HEADER (undocumented) or +# configure.ac and the macro definitions in aclocal.m4. Run by +# autoreconf if configure.ac (or one of the macros it uses) +# contains AC_CONFIG_HEADERS, AC_CONFIG_HEADER (undocumented), or # AM_CONFIG_HEADER (obsolete). # automake Generates Makefile.in from Makefile.am for each Makefile -# specified in configure.ac. Also updates build scripts like -# compile, depcomp, install-sh, ylwrap,... -# Must be run whenever Makefile.am, configure.ac or aclocal.m4 -# has been modified and configure.ac (or one of the macros it +# listed in configure.ac (using AC_CONFIG_FILES). Also updates +# build scripts like compile, depcomp, install-sh, ylwrap,... +# Run by autoreconf if configure.ac (or one of the macros it # uses) contains AM_INIT_AUTOMAKE. -# autopoint Updates gettext related *.m4 files and build scripts such as -# config.rpath. -# If a port uses gettext, this command must be run whenever -# aclocal must be run such that the gettext macros in aclocal.m4 -# have the same version as the gettext build scripts. -# libtoolize Updates libtool related *.m4 files and build scripts such as -# ltmain.sh. -# If a port uses libtool, this command must be run whenever -# aclocal must be run such that the libtool macros in aclocal.m4 -# have the same version as the libtool build scripts. +# +# Autoreconf may also run these additional commands provided by other ports. +# A port needs to have a build depdendency on these ports when that's the case. +# +# autopoint Provided by devel/gettext-tools. Updates gettext related *.m4 +# files included with the source code and build scripts such as +# config.rpath. Run by autoreconf if configure.ac (or one of the +# macros it uses) contains AM_GNU_GETTEXT. A build dependency on +# devel/gettext-tools can be added with USES+=gettext-tools. +# Note that autoreconf runs autopoint even if a port has an NLS +# option and the option is disabled. The build dependency on +# gettext-tools is not optional. If the run dependency on +# gettext is optional this can be specified with +# NLS_USES=gettext-runtime. +# libtoolize Provided by devel/libtool. Updates libtool related *.m4 files +# included with the source code and build scripts such as +# ltmain.sh. Run by autoreconf if configure.ac (or one of the +# macros it uses) contains AC_PROG_LIBTOOL or LT_INIT. A build +# dependency on devel/libtool is added implicitly when USES +# contains both autoreconf and libtool. # # Feature: autoreconf # Usage: USES=autoreconf or USES=autoreconf:args