diff options
author | Eric Blake <eblake@redhat.com> | 2016-12-22 17:16:08 -0600 |
---|---|---|
committer | Eric Blake <eblake@redhat.com> | 2016-12-23 10:00:56 -0600 |
commit | 968215e7b4ea65e32ca7eda8fc5b211b4cec61d0 (patch) | |
tree | 13c1e0e1d183be2cb1dff0e95dfbb3b39d374f4a /bin | |
parent | a6b2acf29d66a1824572c27c2104d24a2b034790 (diff) | |
download | autoconf-968215e7b4ea65e32ca7eda8fc5b211b4cec61d0.tar.gz |
doc: Mention effect of 'autoreconf -fi' on INSTALL
Several projects have a bootstrap script that invokes
'autoreconf -fi' as part of a fresh version control checkout,
in order to avoid storing common files in version control,
while also allowing contributors to rerun bootstrap to pick
up the benefits of any upgrade of one of the autotools.
However, the documentation did not make it obvious that such
a setup will overwrite any customizations to files like
INSTALL, if those files are stored in version control, when
automake still considers that file to be standard based on
AM_INIT_AUTOMAKE settings. In such a case, a mere
'autoreconf -i' is good for the bootstrap script, while a
separate 'autoreconf -f' is good for picking up on an upgrade
of any autotools.
* bin/autoreconf.in (help): Mention standard files.
* doc/autoconf.texi (autoreconf Invocation): Add more text, including
warning that mixing --force and --install may undo customizations,
and that the set of files impacted is controlled by automake.
Reported by Emil Laine <laine.emil@gmail.com>
Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'bin')
-rw-r--r-- | bin/autoreconf.in | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/bin/autoreconf.in b/bin/autoreconf.in index da5b3ea8..b401d01f 100644 --- a/bin/autoreconf.in +++ b/bin/autoreconf.in @@ -69,8 +69,8 @@ Operation modes: -V, --version print version number, then exit -v, --verbose verbosely report processing -d, --debug don't remove temporary files - -f, --force consider all files obsolete - -i, --install copy missing auxiliary files + -f, --force consider all generated and standard files obsolete + -i, --install copy missing standard auxiliary files --no-recursive don't rebuild sub-packages -s, --symlink with -i, install symbolic links instead of copies -m, --make when applicable, re-run ./configure && make |