Date: Mon, 14 Jan 2019 17:01:23 +0000 (UTC) From: Tijl Coosemans <tijl@FreeBSD.org> To: ports-committers@freebsd.org, svn-ports-all@freebsd.org, svn-ports-head@freebsd.org Subject: svn commit: r490303 - head/Mk/Uses Message-ID: <201901141701.x0EH1N9H074668@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201901141701.x0EH1N9H074668>