m4: speed up filesystem modification checks

The current code sleeps at least 1 second to make sure the generated
files are strictly newer than the source files.  It does this for a
few reasons: POSIX only guarantees that `sleep` accept integers, and
filesystems have a history (c.f. Windows) of bad timestamp resolution.

For the first part, we can easily probe sleep to see if it accepts a
decimal number with a fractional part -- just run `sleep 0.001`.

For the second part, we can create two files and then run sleep in a
loop to see when one is considered newer than the other.

For many projects, this 1 second delay is largely amortized by the
rest of the configure script.  Autoconf lends itself to being both
large & slow.  But in projects with many smallish configure scripts
with many cached vars, the time to rerun is dominated by this single
sleep call.  For example, building libgloss against a compiler with
many (60+) multilib configurations, we see:
[Using sleep 1]
$ time ./config.status
real    2m28.164s
user    0m33.651s
sys     0m9.083s
[Using sleep 0.1]
$ time ./config.status
real    0m39.569s
user    0m33.517s
sys     0m8.969s

And in case anyone wonders, going below 0.1s doesn't seem to make a
statistically significant difference, at least in this configuration.
It appears to be within "noise" limits.
[Using sleep 0.001]
$ time ./config.status
real    0m39.760s
user    0m33.342s
sys     0m9.080s

* NEWS: Mention updated timestamp checking.
* m4/sanity.m4: Determine whether `sleep` accepts fractional seconds.
Determine (roughly) the filesystem timestamp resolution.  Use this to
sleep less when waiting for generated file timestamps to update.

m4: cache build env sanity checks

When rerunning configure in an existing build dir, cache the previous
results about environment settings.  There should be no need to retest
these in a dir that has already been configured.

* m4/sanity.m4: Cache sanity results.

elisp: run emacs with --no-site-file

Fixes automake bug https://bugs.gnu.org/21547.

If users have interactive site file logic, the lispdir probing can
hang, as can the compilation of elisp files.  Use --no-site-file to
disable loading any of that possible user logic.

* NEWS: Note emacs --no-site-file change.
* doc/automake.texi: Run emacs with --no-site-file.
* lib/am/lisp.am: Likewise.
* m4/lispdir.m4: Likewise.

ar-lib: ignore -nologo option

We already invoke $AR with -NOLOGO all the time, so we can ignore the
option entirely if the user specifies it.

* lib/ar-lib: Ignore -NOLOGO.

tests: do not assume AM_MAKEINFOHTMLFLAGS is used in non-html targets

Fixes automake bug https://bugs.gnu.org/30172.

Since AM_MAKEINFOHTMLFLAGS overrides AM_MAKEINFOFLAGS only for html
targets, make sure we restore the hacked up makefile before testing
the non-html formats.  This normally doesn't cause a problem for most
people, but if their tex install doesn't work correctly, texi2dvi will
fallback to running $MAKEINFO and using invalid flags in the process.

* THANKS: Add Mathieu Lirzin.
* t/txinfo-many-output-formats.sh: Restore Makefile.am after testing
html targets.
* t/txinfo-many-output-formats-vpath.sh: Likewise.

py-compile: fix display when compiling multiple files

The compilation steps print the filename as it runs, but forgets to add
a space after it, so they all get squashed together:
$ ./py-compile 1.py 2.py 3.py
Byte-compiling python modules...
1.py2.py.3.py

* lib/py-compile: Add missing write.

manual: document Python version support status

Clarify to users what versions of Python are supported and until when.
This will make it easier for us to decide what versions to support.

* doc/automake.texi: Add Supported Python versions section.

py-compile: drop support for Python 0.x & 1.x

Python 2.0 was released in 2000.  There's really no way for us to check
those old versions, so let's just drop them.  No one will miss them.

* NEWS: Note Python version support removal.
* lib/py-compile: Abort if major version 0 or 1 is found.
* t/py-compile-env.sh: Rework slightly to handle new version probing.

py-compile: handle filenames with whitespace

The list of files is put into a string and then split on whitespace.
Fix the way the list of files are passed to the compile script.

* lib/py-compile: Pass files as arguments, not as a string.
* t/py-compile-files.sh: New test.

py-compile: clean up usage info

Include the full summary of options in the output.

* lib/py-compile: Update usage output.
* t/py-compile-usage.sh: Update test to match new output.

maint: include versioned manual in update

When publishing the updated manual, include the versioned copy too,
and have their index.html link to the full version index.

* maintainer/maint.mk: Copy manual to manual/$(VERSION)/, and insert
index-full.html link into index.html.

AM_PROG_AR: require before AC_PROG_AR

The new autoconf AC_PROG_AR macro has similar logic to what we have in
AM_PROG_AR, but less than what we need (since autoconf doesn't support
the MS archiver), so make sure we are run before AC_PROG_AR.

* m4/ar-lib.m4: Call AC_BEFORE for AC_PROG_AR.

maint: Update files from upstream with 'make fetch'

* lib/config.guess: Update.
* lib/config.sub: Likewise.
* lib/gendocs.sh: Likewise.
* lib/gendocs_template: Likewise.
* lib/gitlog-to-changelog: Likewise.
* lib/gnupload: Likewise.
* lib/texinfo.tex: Likewise.
* lib/update-copyright: Likewise.

maint: only sync the manual subdir

This code only updates files under manual/, so no need to checkout the
entire site first.

* maintainer/maint.mk: Only checkout $(PACKAGE)/manual tree.

texi: define new AM_TEXI2FLAGS variable

To provide a bit more flexibility when invoking TEXI2DVI & TEXI2PDF,
and provide a bit of symmetry with .info & .html generation, provide
a AM_TEXI2FLAGS setting that is passed to all TEXI2xxx invocations.

* doc/automake.texi: Mention new AM_TEXI2FLAGS setting.
* lib/am/texibuild.am: Pass $(AM_TEXI2FLAGS) to TEXI2DVI & TEXI2PDF.
* NEWS: Mention AM_TEXI2FLAGS.
* t/txinfo-many-output-formats.sh: Check for AM_TEXI2FLAGS.

texi: pass automatic -I to dvi & pdf generation

Fixes automake bug https://bugs.gnu.org/23599.

When generating info/html pages, automake adds -I flags to source
dirs that contain the texi files, but it doesn't do this for dvi or
pdf formats.  Instead, automake has been relying on texi2dvi to use
makeinfo for expanding macros, and it hasn't done that by default in
a long time.

Since adding --expand to the texi2dvi call is undesirable (due to bad
and unpredictable BEHAVIOR), pass those automatic -I flags directly
to TEXI2DVI & TEXI2PDF so they work regardless of --expand behavior.

We have to keep the MAKEINFO= setting around as texi2dvi might itself
fall back to it if the version of tex is old or broken.

* bin/automake.in: Add comment about $makeinfoflags usage.
* doc/automake.texi: Mention automatic -I subdir flags.
* lib/am/texibuild.am: Pass %MAKEINFOFLAGS% to TEXI2DVI & TEXI2PDF.
* t/txinfo-subdir-pr343.sh: Check for -I subdir usage.

tests: remove spurious +x bits

None of these files are (or can be) executed directly, so drop the
spurious +x permission bit.  None of the other tests do this either.

* t/built-sources-install-exec.sh: Remove +x bit.
* t/ccnoco-deps.sh: Likewise.
* t/ccnoco-lib.sh: Likewise.
* t/ccnoco-lt.sh: Likewise.
* t/perf/cond.sh: Likewise.
* t/perf/testsuite-recheck.sh: Likewise.
* t/perf/testsuite-summary.sh: Likewise.
* t/python-prefix.sh: Likewise.
* t/tags-lisp-space.sh: Likewise.
* t/test-extensions-empty.sh: Likewise.

tests: add coverage for nobase_ and dist_ prefixes

From automake bug https://bugs.gnu.org/14245.

We have tests that check nobase_ and nodist_ interaction, but not
nobase_ and dist_.  We had a report against automake 1.12 that this
combo did not work.  It seems to work now, but lets include a test
to make sure we don't regress.

Based on Daiki Ueno's example, but fixed up to pass against master.

* t/list-of-tests.mk: Add t/nobase-dist.sh.
* t/nobase-dist.sh: New test.

python: add 3.10 - 3.15 to the version search list

Fixes automake bug https://bugs.gnu.org/53530.

Based on the cadence of Automake releases, add the current Python
release (3.10), the current Python development (3.11), and then 4
more versions on top of that.  It doesn't hurt to check for a few
extra versions here since this is the fallback logic when the main
`python` and `python3` programs aren't found.

* m4/python.m4: Add python3.10 - python3.15.
* NEWS: Mention new Python versions.

progs, libs: support _RANLIB overrides

Much like we have per-target support for _AR and _LINK, add an _RANLIB
override too.  This allows selection of specific ranlib tools in case
a non-standard archiver tool was forced.

* bin/automake.in: Check for _RANLIB per-target settings.
* doc/automake.texi: Document _RANLIB override.
* lib/am/library.am: Change $(RANLIB) to $(%XLIBRARY%_RANLIB).
* t/list-of-tests.mk: Add ranlib_override.sh.
* t/ranlib_override.sh: New test.
* NEWS: Mention new feature.

tests: add _AR override coverage

There were no tests for per-target _AR settings, so add some.

* t/ar_override.sh: New test.
* t/list-of-tests.mk: Add ar_override.sh.

tests: clear autotools env vars

Fixes automake bug https://bugs.gnu.org/16714.

The testsuite will try and retain these env vars when recursively
running itself, but doesn't distinguish between vars coming from
the env where the tests were launched.  This breaks if the user
happens to `export ACLOCAL=alocal` before `make check`.

This gets a little more confusing in that the Makefile appears to
export these already:
ACLOCAL = ".../automake/pre-inst-env" aclocal-1.16

In reality, while those are set in the make execution environment,
they aren't exported into the process environment, so children
(i.e. shell processes in make rules) don't have them set.  That's
why tests work for most people today.

However, if the user has first exported "ACLOCAL" in the parent
make environment (regardless of value), then make's value will
reset the process environment, and then that will leak into the
children.  That's why we see errors that look like the makefile
env vars are leaking for these people.

At any rate, the fix is to update the test harness to clear these
vars that the test suite relies upon, especially the ones that are
also set in the Makefiles.  That includes AUTOUPDATE even though
it currently isn't used inside any of the tests.

* t/local.mk: Add ACLOCAL, AUTOCONF, AUTOHEADER, AUTOMAKE, and
AUTOUPDATE to the env unset list.
* t/ax/runtest.in: Likewise.

aclocal: add m4 search path info to --help

Add a short summary to --help of the current paths that will be
searched.  Make sure to omit this from the man page when running
help2man since pre-inst-env specifically clears some and others
to the current build directory.

* bin/aclocal.in: Include m4 search paths in usage.
* doc/local.mk: Run help2man with AUTOMAKE_HELP2MAN=true.

tests: fix quoting in eval

We need to escape the quotes so eval sees them when expanding the
variable value, not when quoting the variable name itself.

* t/local.mk: Escape quotes to eval.

doc: singular/plural agreement, since it's easy.

* HACKING: singular/plural agreement.
* t/README: likewise.

THANKS: fix sorting

* THANKS: Sort a bunch of names.

build: fix ChangeLog generation in external build directory

When gitlog-to-changelog is run in a build directory that is neither the same
as, nor a subdirectory of, the source directory, it needs a --srcdir option or
it will fail to generate the changelog.  For instance

$ git clone https://git.savannah.gnu.org/git/automake.git
…
$ (cd automake && ./bootstrap)
$ mkdir b-automake
$ cd b-automake
$ ../automake/configure
…
$ make dist
…
  GEN      ChangeLog
gitlog-to-changelog:../s-automake/.git-log-fix: unused entry: 22729165f6bb902daeb8a4d8e7cb06982390f327
gitlog-to-changelog:../s-automake/.git-log-fix: unused entry: 3b369e6bbe0fb6d7359398935706c87dd9375cb6
make[2]: *** [../automake/maintainer/maint.mk:48: ChangeLog] Error 1

 * maintainer/maint.mk (gitlog_to_changelog_options): Add --srcdir option.

build: fix race in parallel builds

As reported by Hongxu Jia:
> The automake-$(APIVERSION) is a hardlink of automake, if it is
> created later than update_mans executing, there is a failure
> [snip]
> |: && mkdir -p doc && ./pre-inst-env /usr/bin/env perl ../automake-1.16.1/doc/help2man --output=doc/aclocal-1.16.1 aclocal-1.16
> |help2man: can't get `--help' info from aclocal-1.16
> |Try `--no-discard-stderr' if option outputs to stderr
> Makefile:3693: recipe for target 'doc/aclocal-1.16.1' failed
> [snip]
>
> The automake_script is required by update_mans and update_mans
> invokes automake-$(APIVERSION) rather than automake to generate
> doc, so we should assign `automake-$(APIVERSION)' to automake_script.
>
> The same reason to tweak aclocal_script.

However, rather than update the _script variables to point to the
hardlinked copies of the programs, we can have the help2man steps
run the existing scripts directly.  This makes the relationship a
bit more explicit and avoids implicit dependencies on names.

* doc/local.mk: Pass $(aclocal_script) and $(automake_script) to $(update_mans).
* THANKS: Add Hongxu Jia.

lib: drop unused shell variables

Detected by ShellCheck.

* lib/depcomp: Drop never used $digits.
* lib/ylwrap: Drop --basedir and $basedir, seems like that was old
C&P error from 210797967a.

gitignore: drop redundant config.h.in~ rule

Since we're ignoring all *~ files, we don't need this explicit one.

* .gitignore: Delete config.h.in~ rule.

doc: use gender-neutral pronouns in t/README

* t/README: s/him/them/

tests: fix py-compile-basedir.sh: missing "test"

Prompted by a patch from Thomas Deutschmann <whissi@gentoo.org>,
via https://lists.gnu.org/r/automake-patches/2022-01/msg00001.html:
commit v1.16.1-26-gb279a0d46 ("tests: in python tests, do not
require .pyo files (for python3)") was missing a `test` call.
Reported to Gentoo at https://bugs.gentoo.org/715040.
* t/py-compile-basedir.sh: Rather than just adding the missing
"test", rewrite using a case statement, to avoid some duplication.

maint: make update-copyright

doc: %reldir% and %canon_reldir% do not expand to the empty string.

This change fixes https://bugs.gnu.org/52500.

* doc/automake.texi (Include): correct wrong text.
(Along the way, correct plain-text "Makefile" to "@file{Makefile}".)

configure: skip kcc on case-insensitive filesystems; add clang++.

This change fixes https://bugs.gnu.org/21336.

* configure.ac: Skip KCC check on case-insensitive filesystems; on
macOS 10.10 and later, a kerberos tool named "kcc" is installed.
Add clang++ to the C++ search list, as with current autoconf.

maint: update .gitignore.

* .gitignore: ignore *~ .# and (from Zack Weinberg, autosave files)
.*.sw[op] \#*#, closer to matching Autoconf.
https://lists.gnu.org/archive/html/automake-patches/2021-12/msg00005.html
https://lists.gnu.org/archive/html/automake-patches/2021-12/msg00010.html

m4: replace AC_DIAGNOSE with m4_warn

AC_DIAGNOSE was marked obsolete with autoconf-2.62 in 2008.

* m4/obsolete.m4: Change AC_DIAGNOSE to m4_warn.

dejagnu: add support for silent builds with site.exp.

* lib/am/dejagnu.am (site.exp): Use $(AM_V_GEN) and merge all
independent shell calls into one.

doc: rearrange Multiple Outputs node.

This change fixes https://bugs.gnu.org/48188.

* doc/automake.texi (Multiple Outputs): move GNU pattern rule
approach to the front, since it is probably best if GNU make
can be assumed.  Suggestion from Frank Heckenbach.
Also, remove one of the examples that did not work, per Paul Smith.

config headers: add support for silent builds

* lib/am/remake-hdr.am (%STAMP%): Use $(AM_V_at) and $(AM_V_GEN).
(%CONFIG_HIN%): Likewise.

doc: correct @node placement for new subsubsection.

This change addresses https://bugs.gnu.org/51532.

* doc/automake.texi (Linking Multiple Yacc Parsers): unfortunately
I misplaced the @node after the @subsection; correct that.

maint: Post-release administrivia

* configure.ac (AC_INIT): Bump version number to 1.16i.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").

version 1.16.5

* configure.ac (AC_INIT): Bump version number to 1.16.5.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").
* NEWS: Record release version.

maint: don't use obsolescent "egrep"

* maintainer/syntax-checks.mk (sc_perl_local): Use grep -E
in place of "egrep".

maint: remove trailing white space from a few files

* NEWS: Remove trailing white space.
* NEWS-2.0: Likewise.
* contrib/checklinkx: Likewise.
* doc/local.mk (chlx_args): Likewise.
* m4/python.m4: Likewise.
* t/test-extensions-empty.sh: Likewise.

doc: show "RUNNING: <testname>" example using [AM_]TESTS_ENVIRONMENT.

This change addresses https://bugs.gnu.org/49309.

* doc/automake.texi (Testsuite Environment Overrides): new
subsubsection, separating out [AM_]TESTS_ENVIRONMENT description.
Add example to get "RUNNING: <testname>" when a test starts.

doc: tweak Yacc/Lex text; subnode for the yacc linking hack.

* doc/automake.texi (Alternative): remove obsolete footnote.
(Yacc and Lex): tweak wording, more consistent capitalization.
(Linking Multiple Yacc Parsers): new subsection.

Also add @shortcontents.
Also update texinfo-master-menu (for the first time in ages).

maint: Update files from upstream with 'make fetch'.

* lib/config.sub: Update.

maint: Post-release administrivia

* configure.ac (AC_INIT): Bump version number to 1.16h.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").

maint: adjust version for snapshot

* configure.ac (AC_INIT): Bump version number to 1.16g for snapshot.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").

python: only use Python's sys.* values if the new option

--with-python-sys-prefix is specified; otherwise, return to
previous behavior of using the GNU ${prefix} and ${exec_prefix}.

* doc/automake.texi (Python): document the new behavior.
* m4/python.m4 (AM_PATH_PYTHON): conditionalize use of Python's
sys.* values on the new option --with-python-sys-prefix.
* t/python-prefix.sh: doc update.
* t/python-vars.sh: test both GNU and Python prefix values.
* NEWS: mention this.

doc: update NEWS for yyerror const arg; update THANKS.

* THANKS: update with missed recent committer.
* NEWS: mention yyerror decl in our tests now uses const.

tests: let yacc's yyerror take its argument as a const string

Some of yacc error messages are const strings; it makes no sense for
yyerror to take a 'char *', it should be a 'const char *' as POSIX now
requires.

Fixes all the failures reported by Kiyoshi Kanazawa.
<https://lists.gnu.org/r/bug-bison/2021-09/msg00005.html>
See bug#50469 <https://debbugs.gnu.org/50469>.

* t/cond35.sh, t/silent-many-languages.sh, t/silent-yacc-headers.sh,
* t/silent-yacc.sh, t/subpkg-yacc.sh, t/suffix10.tap, t/yacc-basic.sh,
* t/yacc-clean.sh, t/yacc-d-basic.sh, t/yacc-d-vpath.sh,
* t/yacc-deleted-headers.sh, t/yacc-depend.sh, t/yacc-depend2.sh,
* t/yacc-dist-nobuild-subdir.sh, t/yacc-dist-nobuild.sh, t/yacc-dry.sh,
* t/yacc-line.sh, t/yacc-misc.sh, t/yacc-mix-c-cxx.sh, t/yacc-nodist.sh,
* t/yacc-pr204.sh, t/yacc-subdir.sh, t/yacc-vpath.sh,
* t/yflags-cmdline-override.sh, t/yflags-force-override.sh
(yyerror): From 'char *' to 'const char *'.
Enforce consistency: prefer '{}' to '{ return; }'.

automake: consistently depend on install-libLTLIBRARIES.

Report and patch:
https://lists.gnu.org/archive/html/automake/2021-08/msg00016.html

* bin/automake.in (generate_makefile): depend on
install-libLTLIBRARIES for all PROGRAMS and LTLIBRARIES,
such as install-pkglibLTLIBRARIES.
* NEWS: mention this.

automake: fatal error on second AM_INIT_AUTOMAKE.

This change addresses https://bugs.gnu.org/50046.
Patch posted:
https://lists.gnu.org/archive/html/automake-patches/2021-08/msg00000.html

* m4/init.m4: Make attempts to expand AM_INIT_AUTOMAKE more than
once a fatal error at m4 time.

maint: Update doc/help2man.

* doc/help2man: update to 1.48.24

maint: Update doc/help2man.

* doc/help2man: update to 1.48.2.

doc: typos from codespell.

* HACKING: typo from codespell.
* doc/local.mk: likewise.
* lib/am/header-vars.am: likewise.
* lib/am/lisp.am: likewise.
* t/cond24.sh: likewise.
* t/cond36.sh: likewise.
* t/dist-auxdir-many-subdirs.sh: likewise.
* t/link_override.sh: likewise.
* t/parallel-tests-console-output.sh: likewise.
* t/subobj11a.sh: likewise.
* t/subobj11b.sh: likewise.

cosmetics: py-compile consistently use test, not [ ... ]; indentation.

* lib/py-compile: consistently use test rather than [ ... ];
use consistent sh indentation; check exit status consistently.

maint: Post-release administrivia

* configure.ac (AC_INIT): Bump version number to 1.16f.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").

version 1.16.4

* configure.ac (AC_INIT): Bump version number to 1.16.4.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").
* NEWS: Record release version.

maint: Update files from upstream with 'make fetch'.

* lib/gendocs.sh: Update.

maint: adjust version, post-snapshot

* configure.ac (AC_INIT): Bump version number to 1.16e for snapshot.
* m4/amversion.m4: Regenerate.

maint: adjust version for snapshot

* configure.ac (AC_INIT): Bump version number to 1.16d for snapshot.
* m4/amversion.m4: Likewise (auto-updated by "make bootstrap").

doc: NEWS tweak

* NEWS: Indent consistently.

doc: update HACKING.

* HACKING: update for some current realities.

tests: use testsuite/ directory in DejaGnu tests

Patch posted:
https://lists.gnu.org/archive/html/automake-patches/2021-07/msg00009.html

* t/check12.sh: Consistently use the directory name, testsuite/,
for all DejaGnu tests, and always use recursive make to run
DejaGnu, for backward and forward compatibility.
* t/dejagnu3.sh: Likewise.
* t/dejagnu4.sh: Likewise.
* t/dejagnu5.sh: Likewise.
* t/dejagnu6.sh: Likewise.
* t/dejagnu7.sh: Likewise.
* t/dejagnu-absolute-builddir.sh: Likewise.
* t/dejagnu-relative-srcdir.sh: Likewise.
* t/dejagnu-siteexp-extend.sh: Likewise.
* t/dejagnu-siteexp-useredit.sh: Likewise.
* NEWS: mention this.
* THANKS: new contributor.

automake: silent make output for custom link commands.

Patch posted:
https://lists.gnu.org/archive/html/automake-patches/2021-07/msg00010.html

* bin/automake.in (define_per_target_linker_variable): Use
AM_V_${target}_LINK if defined as the verbose variable name for
custom link commands.
* doc/automake.texi (Program and Library Variables): Document the new
variable.
* t/link_override.sh: Add extra checks for silent make rules.
* NEWS: Mention this.
* THANKS: new contributor.

maint: avoid syntax-check failures

* maintainer/syntax-checks.mk (toupper): Tighten the regexp
to avoid a new false-match in t/python-prefix.sh.
* t/instmany-python.sh: Use run_make in place of some $MAKE uses.
* t/python-prefix.sh: Likewise.
* t/python-vars.sh: Likewise.

maint: make update-copyright

maint: tweak comment wording

* doc/automake.texi (List of Automake options): Nit.
* t/dist-no-built-sources.sh: Likewise.

no-dist-built-sources: fix-up

* bin/automake.in (preprocess_file): Process new option here,
(handle_dist): ... not here.
* lib/Automake/Options.pm (_is_valid_easy_option):
Remove pure-dist.
* lib/am/distdir.am: Don't factor out the duplicate-looking
$(MAKE)... command.  Otherwise, many dist-using tests would fail
for me, e.g., t/aclocal-amflags.sh.

test: disable use of ksh in a test that would otherwise hang

* t/tests-environment-fd-redirect.sh: This test would hang when
using ksh93 from Fedora 34 and CentOS 8.  Comments demonstrate
the issue reported as https://github.com/ksh93/ksh/issues/316

doc: update THANKS.

* THANKS: mention contributors over the past couple years.

dist: add new "dist-no-built-sources" automake option.

Fixes automake bug https://debbugs.gnu.org/49317.

* bin/automake.in: implement new option "no-dist-built-sources" to
omit the dependency of distdir on $(BUILT_SOURCES).  (Allison's
original patch used the option name dist-pure; trivially renamed.)
* lib/am/distdir.am (distdir) [DIST_BUILT_SOURCES]: conditionalize
the dependency.
* lib/Automake/Options.pm (_is_valid_easy_option): list it.
* doc/automake.texi (List of Automake options): document it.
* NEWS: mention it.
* t/dist-no-built-sources.sh: test it.
* t/list-of-tests.mk (handwritten_TESTS): add it.

maint: missed commits.

* INSTALL: Update from gnulib via make fetch.
* NEWS: mention config.{guess,sub} restoration of `...`.

maint: Update files from upstream with 'make fetch'

* lib/INSTALL: Update.
* lib/config.guess: Likewise.
* lib/config.sub: Likewise.
* lib/gendocs.sh: Likewise.
* lib/gendocs_template: Likewise.
* lib/gitlog-to-changelog: Likewise.
* lib/gnupload: Likewise.
* lib/texinfo.tex: Likewise.
* lib/update-copyright: Likewise.

tests: forgot to remove dev exit 33 from new test.

* t/toplevelmd.sh: normal ending.

dist: accept .md versions for README et al.

This change was suggested by madmurphy; some ideas were taken
from the patch he provided.
https://lists.gnu.org/archive/html/automake-patches/2021-06/msg00005.html

* bin/automake.in (@toplevelmd_ok): new global, listing the files
for which we will accept .md versions.
(@common_files): remove those files from there.
(handle_dist): check for .md if non-.md is absent.
(handle_minor_options): check for README-alpha.md.
(check_gnu_standards): accept .md version if present.
(check_gnits_standards): likewise.
(usage): output list of .md-accepted files.
* doc/automake.texi (Basics of Distribution): document.

* t/toplevelmd.sh: new test.
* t/list-of-tests.mk (handwritten_tests): add it.
* NEWS: mention new feature.

doc: omit "really" from manual.

* doc/automake.texi: remove or replace "really".

doc: --always-make doesn't work.

* doc/automake.texi (Rebuilding): the GNU Make option
--always-make does not work with Automake.
Report from Johan Persson,
https://lists.gnu.org/archive/html/automake/2021-06/msg00002.html.
Also, use "GNU Make" (capital M) more consistently.

doc: wording.

* README:
* t/python-virtualenv.sh:
* doc/automake.texi: wording, typos, etc.

doc: move future 2.0 incompatibilities to separate file.

* NEWS: move info to ...
* NEWS-2.0: ... this new file.
* Makefile.am (EXTRA_DIST): add it.

python: new python-prefix test.

* t/python-prefix.sh: new test.
* t/list-of-tests.mk (handwritten_tests): add it.
* NEWS: describe new Python prefix behavior.

python: use Python's sys.prefix and sys.exec_prefix

for PYTHON_PREFIX and PYTHON_EXEC_PREFIX; new configure options
--with-python_prefix and --with-python_exec_prefix to set explicitly.

This change fixes https://bugs.gnu.org/35322.

* m4/python.m4 (AM_PATH_PYTHON): use Python's sys.prefix and
sys.exec_prefix for PYTHON_PREFIX and PYTHON_EXEC_PREFIX,
instead of $prefix and $exec_prefix. But use a variable
reference to ${prefix} if it is contained within sys.prefix;
similarly for exec_prefix. Also support new configure options
to set explicitly.
(PYTHON_PREFIX, PYTHON_EXEC_PREFIX): AC_SUBST these.
(am_cv_python_pythondir): use our new $am_cv_python_prefix,
substituting ${PYTHON_PREFIX}.
(am_cv_python_pyexecdir): likewise.
* doc/automake.texi (Python): PYTHON_PREFIX, PYTHON_EXEC_PREFIX,
document new approach.
* t/instmany-python.sh: set PYTHON_PREFIX as needed.
* t/python-vars.sh (PYTHON_EXEC_PREFIX, PYTHON_PREFIX): also set from
Python's sys.{exec_,}prefix; use ${PYTHON_{EXEC,}PREFIX} instead
of ${exec_,}prefix.

doc: HACKING updates.

* HACKING: some additional tidbits.

automake: sort hash keys needed for reproducible output.

This change fixes https://bugs.gnu.org/46744.

* bin/automake.in: sort keys, in: handle_LIBOBJS, handle_clean,
 handle_factored_dependencies, scan_autoconf_traces,
 lang_vala_finish.
* NEWS: mention this.

doc: a_LDFLAGS always overrides AM_LDFLAGS.

This change addresses https://bugs.gnu.org/34925.

* doc/automake.texi (Program and Library Variables): document
that using a_LDFLAGS at all, even in the false branch of a
conditional, means that AM_LDFLAGS is ignored.

doc: [AM_]RUNTESTFLAGS not [AM_]RUNTESTDEFAULTFLAGS.

* doc/automake.texi (Other Variables): Change [AM_]RUNTESTDEFAULTFLAGS
to [AM_]RUNTESTFLAGS.

doc: user flags last does not always allow overriding.

This change addresses https://bugs.gnu.org/35526.

* doc/automake.texi (Flag Variables Ordering): recognize that
user flags last does not always allow overriding.

doc: discuss AC_* ordering a little.

* doc/automake.texi (Optional): mention that AC_CONFIG_AUX_DIR
must be called before AM_INIT_AUTOMAKE, and recommend that other
AC_CONFIG_* macros be called after.  This seems to be the most
common practice.  Autoconf does not currently impose ordering:
https://savannah.gnu.org/support/?110416

Fix some build and test failures with Autoconf 2.70.

Autoconf 2.70 (released last week) makes a few changes that broke Automake’s
expectations, mostly in the test suite.  This patch addresses two of the
problems:

 - autoconf now issues a warning if fed a configure script that doesn’t invoke
   both AC_INIT and AC_OUTPUT; this, plus a problem with system-provided
   tools (still under investigation) broke the *build* on macOS; it also
   causes a couple of spurious testsuite failures.

 - AC_PACKAGE_NAME and AC_PACKAGE_VERSION are now defined unconditionally.
   AM_INIT_AUTOMAKE needs to use m4_ifset instead of m4_ifdef to diagnose
   the obsolete use of AC_INIT with fewer than two arguments.  (This change
   is compatible with autoconf 2.69; m4_ifset is much older, and it means
   ‘defined with a non-empty value’.)

* configure.ac: Use both AC_INIT and AC_OUTPUT in test configure scripts.
* t/deprecated-acinit.sh, t/init.sh: Likewise.
* m4/init.m4 (AM_INIT_AUTOMAKE): Use m4_ifset, not m4_ifdef, to detect
  AC_PACKAGE_NAME and/or AC_PACKAGE_VERSION not having a value.

python: don't assume $(...) in py-compile.

This change (very) partially fixes https://bugs.gnu.org/45205.

* lib/py-compile: use `...` instead of $(...).
Solaris 10 /bin/sh is still in use.

tests: more .NOTPARALLEL tests.

* t/java-compile-run-nested.sh: .NOTPARALLEL in subdirs too.

tests: more .NOTPARALLEL tests.

* contrib/t/multilib.sh: yet more .NOTPARALLEL for AM_TESTSUITE_MAKE,
found by Jim on heavier machines.
* t/autodist-stamp-vti.sh: likewise.
* t/java-compile-run-nested.sh: likewise.
* t/transform2.sh: likewise.

tests: more .NOTPARALLEL tests.

* contrib/t/multilib.sh: use .NOTPARALLEL to avoid unreproducible
(and undebuggable, by me) test failures when running
  make -j$njobs AM_TESTSUITE_MAKE="make -j$njobs"
for some arbitrary but rather large value of $njobs.
The failures don't occur with just make -j; have to run the makes
inside the tests in parallel also.
* t/java-compile-install.sh: likewise.
* t/java-compile-run-flat.sh: likewise.
* t/java-uninstall.sh: likewise.
* t/vala-headers.sh: likewise.

doc: comment Vala -newer test.

This change updates https://bugs.gnu.org/44772.

* bin/automake.in (lang_vala_finish_target): comment that
we're checking "C file not older than Vala file", and the
log message misleadingly says "reversed".

tags: support setting CTAGS, ETAGS, CSCOPE vars via ./configure.

This change fixes https://bugs.gnu.org/45013.

* m4/init.m4: add default settings and AC_SUBST calls for the variables
  `CTAGS', `ETAGS' and `CSCOPE'.
* lib/am/tags.am: remove default settings of the above variables.
* doc/automake.texi (Tags): mention and index.
* NEWS: mention.

warnings: be less forceful about a missing subdir-objects option.

This change somewhat ameliorates https://bugs.gnu.org/20699.

* bin/automake.in (handle_single_transform): change
forward-incompatibility message for subdir-objects to be
less draconian and less certain that the change will ever be made.
* t/subobj.sh: message text has changed.
* doc/automake.texi (Program and Library Variables): mention
the unfortunate fact that one directory can clean in a sibling,
subdir-objects notwithstanding.

tests: .NOTPARALLEL test-driver-create-log-dir.

* t/test-driver-create-log-dir.sh (.NOTPARALLEL): add target,
since the two tests under sub/ seem to have a race condition.
No evident way to debug or reliably reproduce. Reported by Jim.