+ 2011-09-05 Peter Rosin <peda@lysator.liu.se>
+
+ * tests/amhello-binpkg.test: Add missing $EXEEXT usage.
+
+ 2011-09-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ fix: list test 'vala-vpath.test' in XFAIL_TESTS
+ * tests/Makefile.am (XFAIL_TESTS): Update.
+
+ 2011-09-02 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: simplify wrapper for aclocal
+ * tests/aclocal.in: Remove use of $ACLOCAL_TESTSUITE_FLAGS and
+ extra `-I' flags; they are not really required, since the file
+ `m4/amversion.m4' is generated in the srcdir anyway.
+ * tests/acloca10.test: Remove use of $ACLOCAL_TESTSUITE_FLAGS.
+ * tests/acloca18.test: Likewise.
+ * tests/defs.in: Don't nullify $ACLOCAL_TESTSUITE_FLAGS, and do
+ not export it.
+
+ 2011-09-02 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ coverage: vala support failing for VPATH from-scratch builds
+ * tests/vala-vpath.test: New test, xfailing.
+ * tests/Makefile.am (TESTS): Update.
+ * THANKS: Update.
+ From a report by Zbigniew Jędrzejewski-Szmek.
+ Related to automake bug#8753.
+
+ 2011-09-01 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: report few more automake parsing limitations
+ Partly motivated by automake bug#8360.
+ * doc/automake.texi (General Operation): Report few more automake
+ limitations w.r.t. parsing of unusual makefile constructs. Related
+ minor reorderings.
+ * tests/doc-parsing-buglets-colneq-subst.test: New test.
+ * tests/doc-parsing-buglets-tabs.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-08-25 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: list "forgotten" test script in TESTS
+ * tests/Makefile.am (TESTS): Also list ...
+ * tests/java-empty-classpath.test: ... this test. Since we are
+ at it, remove trailing whitespace from a couple of lines.
+
+ 2011-08-25 Eric Blake <eblake@redhat.com>
+
+ ylwrap: fix unusual indentation whitespace
+ * lib/ylwrap: Convert tabs to spaces.
+ Reported by Karl Berry.
+
+ 2011-08-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ * THANKS (Daniel Richard G.): Update e-mail address.
+
+ 2011-08-16 Daniel Richard G. <skunk@iskunk.org> (tiny change)
+ Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ java: avoid compilation errors when CLASSPATH is empty
+ * lib/am/java.am (CLASSPATH_ENV): When redefining `$CLASSPATH',
+ do not append an empty component in case the previous value of
+ CLASSPATH is empty or unset.
+ * tests/java-empty-classpath.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ Fixes automake bug#9306.
+
+ 2011-08-16 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ parallel-tests: no more spurious successes for FreeBSD make
+ Work around a bug of FreeBSD make bug that was causing the
+ automake-generated "check" target to complete with success
+ even if some tests failed; this happened only when FreeBSD
+ make was run in concurrent mode (as in, e.g., "make -j2
+ check"). The bug is not present in NetBSD make.
+ This change fixes automake bug#9245:
+ <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=9245>
+ See also FreeBSD PR bin/159730:
+ <http://www.freebsd.org/cgi/query-pr.cgi?pr=159730>
+ * lib/am/check.am [%?PARALLEL_TESTS%] $(TEST_SUITE_LOG): Use a
+ more "safe" (and apparently redundant) idiom to exit with error,
+ so that the non-zero exit status is picked up also by FreeBSD
+ make when it's running in concurrent mode.
+ * NEWS: Update.
+ * tests/check-concurrency-bug9245.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-08-11 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ hacking: we now require autoconf 2.68
+ * HACKING ("Working in git"): Use autoconf and autom4te 2.68,
+ not 2.67, in the examples.
+
+ 2011-08-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: more environment cleanup
+ * tests/defs.in: Also unset variables AM_COLOR_TESTS and
+ AM_TESTS_ENVIRONMENT.
+
+ 2011-08-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix spurious failure with Solaris make
+ * tests/distcheck-configure-flags-am.test: Avoid using `+=' too
+ liberally with AM_DISTCHECK_CONFIGURE_FLAGS, since the line breaks
+ so introduced, in conjunction with single quotes, might confuse
+ Solaris make.
+
+ 2011-08-03 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ maintcheck: fix maintainer-check failures, both real and spurious
+ * tests/amhello-binpkg.test: Use "$MAKE", not bare "make".
+ * Makefile.am (sc_perl_local): Also allow perl special variable
+ `$~' to be localized. And be slightly laxer in the regexp, to
+ allow for usages like "local $_ = $foo;".
+ (sc_tests_overriding_macros_on_cmdline): Also allow for command
+ line overriding of the `DISABLE_HARD_ERRORS' make variable. Try
+ to avoid false positives for usages like "$MAKE || st=$?".
+
+ 2011-08-03 Bruno Haible <bruno@clisp.org>
+
+ docs: how to use '-I' option in AM_CPPFLAGS for best VPATH support
+ * doc/automake.texi (Program Variables): Recommend -I options to
+ both the build directory and the source directory when needed.
+
+ 2011-07-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: relax a test on amhello examples to cater to Solaris tar
+ * tests/amhello-binpkg.test: When the tar implementation in use
+ is not GNU tar, relax the tests on tar output, to avoid spurious
+ failures. For example, "tar cvf ..." with GNU tar can output
+ lines like "./usr/bin/hello" on the standard output, while with
+ Solaris tar it can output lines like "a ./usr/bin/hello 8K" on
+ standard output, and with Heirloom tar it can output lines like
+ "a ./usr/bin/hello 15 tape blocks" on standard error.
+
+ 2011-07-15 Benoit Sigoure <tsunanet@gmail.com>
+
+ docs: add references between the 2 sections on java support
+ * doc/automake.texi (Java Support, Java): Add cross-references.
+
+ 2011-07-20 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Sync auxiliary files from upstream.
+ * INSTALL, lib/INSTALL, lib/config.guess, lib/config.sub,
+ lib/texinfo.tex: Sync from upstream.
+
+ 2011-07-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix weakness in 'tests-environment-backcompat.test'
+ * tests/tests-environment-backcompat.test: Do not override the
+ content of xfailing test `baz.test' with a "weaker" version that
+ fails unconditionally: the test must fail only when the 'strict'
+ pragma is in use, in order not to reduce coverage.
+
+ 2011-07-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs, tests: synchronize examples on silent-rules from config.site
+ * doc/automake.texi (Automake silent-rules Option): Reference test
+ 'silent-configsite.test' in comments.
+
+ 2011-07-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: portability fixes in tests on amhello examples
+ * tests/amhello-binpkg.test: Don't use "tar xzf too.tag.gz" to
+ extract a gzip-compressed tarball, that's unportable to some
+ tar implementations; use the "gzip -dc fo.tar.gz | tar xf -"
+ idiom instead.
+ * tests/amhello-cflags.test: Likewise.
+ * tests/amhello-cross-compile.test: Likewise.
+ Suggestion from Ralf Wildenhues.
+
+ 2011-07-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ remake: add test ensuring that slower remakes don't hang
+ * tests/remake-subdir-long-time.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ Suggestion by Ralf Wildenhues.
+
+ 2011-07-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ remake: fix outdated comment in configure.am
+ * lib/am/configure.am: Fix comment falsified by changes in
+ commit `v1.11-366-gbee9871'.
+ Suggestion by Ralf Wildenhues.
+
+ 2011-07-01 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs, tests: synchronize examples from docs to tests
+ * tests/README (Writing test cases): Give suggestions on how to
+ keep test cases and examples in the documentation synchronized.
+ * doc/automake.texi: Improve or fix existing testcase-referencing
+ comments, and add many new ones.
+ * HACKING (Administrivia): Suggest to test complex examples and
+ idioms from the manual.
+ * tests/specflg8.test: Improve synchronization with the example
+ in the manual.
+ * tests/output11.test:Likewise.
+ * tests/txinfo21.test:Likewise.
+ * tests/interp.test: Likewise. Since we are at it, and enable
+ the `errexit' shell flag, do related changes, and add trailing
+ `:'command.
+ * tests/amhello-cflags.test: New test.
+ * tests/amhello-cross-compile.test: Likewise.
+ * tests/amhello-binpkg.test: Likewise.
+ * tests/tests-environment-backcompat.test: Likewise.
+ * tests/parallel-tests-log-compiler-example.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-06-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: avoid a footnote, some related rewordings and improvements
+ * doc/automake.texi (Dist): Reword the part about automatically
+ distributed files to avoid a footnote. Since we are at it, extend
+ a bit, and add an example and a reference to a relevant test case.
+
+ 2011-06-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: minor cosmetic fixes
+ * doc/automake.texi: Break few overly long lines, throughout the
+ file.
+ ("Simple Tests"): Move @vindex for XFAIL_TESTS to the correct
+ position, i.e., before and not after the paragraph where it is
+ introduced.
+ ("Options" @item ansi2knr): Use @pxref instead of @xref. This
+ fixes a texinfo warning.
+ ("Other things Automake recognizes" @item AM_C_PROTOTYPES): Use
+ @pxref instead of @ref.
+
+ 2011-06-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ help: improve text about automatically-distributed files
+ This change fixes automake bug#7819.
+ * automake.in (usage): Distinguish between files that are always
+ automatically distributed when found, and those which are only
+ "under certain conditions".
+ * doc/automake.texi (Basics of Distribution): Update accordingly.
+ * tests/autodist-subdir.test: Update.
+ * tests/autodist-no-duplicate.test: Likewise.
+ * tests/autodist.test: Likewise.
+ (configure.in): Remove useless call to AM_MAINTAINER_MODE.
+
+ 2011-06-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ refactor: split 'usage' subroutine in automake
+ This change is related to automake bug#7819.
+ * automake.in (print_autodist_files): New subroutine,
+ extracted from ...
+ (usage): ... this, which now uses it.
+ * tests/autodist-no-duplicate.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-06-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix bug in 'autodist.test'
+ * tests/autodist.test: Avoid spurious failure due to no
+ `defs-static' file being found in the parent directory.
+
+ 2011-06-21 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ maintcheck: extend 'sc_tests_plain_*' checks
+ * Makefile.am (sc_tests_plain_autom4te): New check.
+ (sc_tests_plain_autoreconf): Likewise.
+ (sc_tests_plain_autoheader): Likewise.
+ (syntax_check_rules): Update.
+
+ 2011-06-20 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ maintcheck: avoid few spurious failures
+ * Makefile.am (sc_tests_plain_aclocal, sc_tests_plain_perl,
+ sc_tests_plain_autoconf, sc_tests_plain_automake,
+ sc_tests_plain_autoupate): Be stricter in matching an erroneous
+ literal command, i.e., `aclocal', `automake', `perl', etc.
+
+ 2011-06-20 Bert Wesarg <bert.wesarg@googlemail.com> (tiny change)
+
+ check: don't use multi-line coloring for the report
+ "less -R" can't handle multi-line coloring as it is done for the
+ check reports of the serial and parallel testsuite, because of
+ performance reasons. Thus, color each line of the check report
+ by its own.
+ * lib/am/check.am (am__text_box): Accept colors for lines, and
+ color each line by its own.
+ [%?PARALLEL_TESTS%] $(TEST_SUITE_LOG): Let am__text_box handle
+ the line coloring.
+ [!%?PARALLEL_TESTS%] $(check-TESTS): Color each report line by
+ its own.
+ * THANKS: Update.
+
+ 2011-06-18 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: AM_DISTCHECK_CONFIGURE_FLAGS is for corner cases
+ * doc/automake.texi (Checking the Distribution): Explain that the
+ developers should take care of making their code buildable without
+ requiring any special configure options, so that in general
+ AM_DISTCHECK_CONFIGURE_FLAGS shouldn't be used. Give an example
+ of where its use is legitimate.
+ Suggestions from Ralf Wildenhues and Eric Blake.
+
+ 2011-06-14 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ ansi2knr: deprecate, it will go away in the next major release
+ * doc/automake.texi: Loudly and repeatedly state that the old
+ de-ANSI-fication features are now deprecated and will be removed
+ in the next major Automake release. Other related adjustments.
+ * lib/Automake/Options.pm (_process_option_list ): Give a warning
+ in the `obsolete' category when the `ansi2knr' option is used.
+ * m4/protos.m4 (AM_C_PROTOTYPES): Deprecate this macro: a warning
+ in the `obsolete' category will be emitted it if is used.
+ * tests/ansi2knr-deprecation.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * tests/ansi.test: Adjust, by calling autoconf and/or automake
+ with the `-Wno-obsolete' flag.
+ * tests/ansi10.test: Likewise.
+ * tests/ansi2.test: Likewise.
+ * tests/ansi3.test: Likewise.
+ * tests/ansi3b.test: Likewise.
+ * tests/ansi4.test: Likewise.
+ * tests/ansi5.test: Likewise.
+ * tests/ansi6.test: Likewise.
+ * tests/ansi7.test: Likewise.
+ * tests/ansi8.test: Likewise.
+ * tests/ansi9.test: Likewise.
+ * tests/cxxansi.test: Likewise.
+ * tests/libobj8.test: Likewise.
+ * NEWS: Update about the future planned backward-incompatibility
+ due to the removal of de-ANSI-fication feature.
+
+ 2011-06-19 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: primary/prefix combination "pkglib_PROGRAMS" is now invalid
+ * doc/automake.texi (Program Sources): pkglib_PROGRAMS is not a
+ valid combination anymore, so don't document it. Inconsistency
+ introduced in commit `v1.11-373-g9ca6326'.
+
+ 2011-06-19 Jim Meyering <meyering@redhat.com>
+
+ docs: replace obsolete @vindex entry with a useful one
+ * doc/automake.texi (Program Sources): Do not index obsolete
+ pkglib_PROGRAMS here. Do index pkglibexec_PROGRAMS.
+
+ 2011-06-13 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: optimize tests on primary/prefix mismatch for speed
+ * tests/primary-prefix-invalid-couples.test: Partial rewrite, in
+ order to use just a single automake invocation rather than one
+ invocation for each invalid primary/prefix couple. This improves
+ the test script execution time by an order of magnitude.
+ Since we are at it, throw in some other improvements to avoid
+ unrelated automake warnings and failures that could potentially
+ cause false positives w.r.t. the automake exit status.
+
+ 2011-06-13 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ news: update w.r.t. introduction of AM_DISTCHECK_CONFIGURE_FLAGS
+ * NEWS (Miscellaneous changes): Update.
+
+ 2011-06-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ maintcheck: DISTCHECK_CONFIGURE_FLAGS can be defined on make cmdline
+ * Makefile.am (sc_tests_overriding_macros_on_cmdline): It's now
+ acceptable that the test scripts override DISTCHECK_CONFIGURE_FLAGS
+ on the make command line. Update comments accordingly. Since we
+ are at it, make the relevant grepping rules slightly tighter.
+
+ 2011-06-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ distcheck: add support for AM_DISTCHECK_CONFIGURE_FLAGS
+ * doc/automake.texi (Checking the Distribution): Suggest to use
+ AM_DISTCHECK_CONFIGURE_FLAGS, not DISTCHECK_CONFIGURE_FLAGS, to
+ define (in the top-level Makefile.am) extra flags to be passed
+ to configure at "make distcheck" time; DISTCHECK_CONFIGURE_FLAGS
+ should be reserved for the user. Add proper `@vindex' directive.
+ Document that AM_DISTCHECK_CONFIGURE_FLAGS is not honoured in a
+ subpackage Makefile.am, but the flags in it are passed down to
+ the configure script of the subpackage.
+ * lib/am/distdir.am (distcheck): Also pass the flags in
+ $(AM_DISTCHECK_CONFIGURE_FLAGS) to the configure invocation.
+ Update comments.
+ * tests/defs.in.test (AM_DISTCHECK_CONFIGURE_FLAGS,
+ DISTCHECK_CONFIGURE_FLAGS): Unset in case they are exported in
+ the environment, they might improperly influence our testsuite.
+ * tests/distcheck-configure-flags.test: New test.
+ * tests/distcheck-configure-flags-am.test: Likewise.
+ * tests/distcheck-configure-flags-subpkg.test: Likewise.
+ * distcheck-hook.test: Likewise.
+ * distcheck-hook2.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+ Closes automake bug#8784.
+
+ 2010-06-09 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: better documentation for silent make rules
+ * doc/automake.texi (Options): Detailed description of the
+ automake option `silent-rules' moved from here ...
+ (Silent Make): ... into this new chapter, expanded, improved,
+ and subdivided into ...
+ (Make verbosity, Tricks For Silencing Make,
+ Automake silent-rules Option): ... these new sections.
+ (@menu, @detailmenu): Update.
+ * tests/silent-configsite.test: New test, checking that the
+ user can control default mode of silent-rules from config.site,
+ as is documented in the manual.
+ * tests/Makefile.am (TESTS): Updated.
+
+ 2011-06-11 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Warnings about primary/prefix mismatch fixed and extended.
+ * automake.in (%standard_prefix): Add `doc' and `locale'.
+ Rename `pkgdatadir' to `pkgdata'. Similarly for`pkglibdir',
+ `pkgincludedir' and `pkglibexecdir'.
+ (handle_programs): List `pkglibexec', not `pkglib', among the
+ prefixes valid for the `PROGRAMS' primary.
+ (handle_data): List also `doc' among the prefixes valid for
+ the `DATA' primary. This is required by automake's own build
+ system.
+ * tests/dirforbid.test: Test removed, superseded by ...
+ * tests/primary-prefix-invalid-couples.test: ... this new test.
+ * tests/primary-prefix-valid-couples.test: New test.
+ * tests/primary-prefix-couples-documented-valid.test: Likewise.
+ * tests/primary-prefix-couples-force-valid.test: Likewise.
+ * tests/java3.test: Adjusted, and extended a bit.
+ * tests/Makefile.am (TESTS): Updated.
+ * NEWS: Updated.
+ From a report by Eric Blake.
+
+ 2011-06-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: new function 'fatal_', for hard errors
+ Before this patch, the only way offered by tests/defs to
+ properly signal a hard error was the `framework_failure_'
+ function. But the error message issued by that function,
+ as its name would suggest, refers to a set-up failure in the
+ testsuite, while hard errors can obviously also be due to
+ other reasons. The best way to fix this inconsistency is to
+ introduce a new function with a more general error message.
+ Inspired by a recent similar change to Gnulib's tests/init.sh.
+ * tests/defs.in (fatal_): New function.
+ * tests/README (Section "Writing test cases" subsection "Do"):
+ Suggest the use of `fatal_', not of `framework_failure_', for
+ generic hard errors. The latter should be reserved for "real"
+ set-up failures.
+
+ 2011-06-02 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ maintcheck: fix some failures, extend some checks
+ * Makefile.am (sc_diff_automake_in_automake): Update, as we
+ now expect 9 lines, not 8, to be changed from `automake.in'
+ to `automake'.
+ (sc_diff_aclocal_in_aclocal): New maintainer check, similar to
+ the above, and checking that only 10 lines are changed from
+ `aclocal.in' to `aclocal'.
+ (syntax_check_rules): Update.
+ (sc_tests_Exit_not_exit): Exempt self tests `self-check-*.test'
+ from this check, as they can legitimately use the bare `exit'
+ builtin in various places.
+ * doc/automake.texi (Python): Remove stray `@' from the end of
+ a line. Typo introduced in commit `v1.11-312-g5bf7af6'.
+ * tests/depcomp8a.test: Pass DISTCHECK_CONFIGURE_FLAGS to make
+ from the environment rather than from the command line, to
+ pacify the `sc_tests_overriding_macros_on_cmdline' maintainer
+ check.
+ * tests/depcomp8b.test: Likewise.
+
+ 2011-05-29 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ remake: behave better with non-GNU make in subdirectories
+ Currently, with every decent make program, it is possible to
+ rebuild out-of-date autotools-generated files with a simple
+ "make Makefile" -- but for this to work reliably with non-GNU
+ make implementations, the command must be issued from the
+ top-level directory. This patch removes such limitation.
+ * lib/am/configure.am (am--refresh): Depend on `%MAKEFILE%'.
+ * tests/defs.in (using_gmake): New function, backported from the
+ `master' branch (and simplified).
+ * tests/remake-subdir.test: New test.
+ * tests/remake-subdir2.test: Likewise.
+ * tests/remake-subdir-gnu.test: Likewise.
+ * tests/remake-subdir-from-subdir.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-05-29 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ automake, aclocal: honour configure-time AUTOCONF and AUTOM4TE
+ Currently, the Automake's own configure script allow definition
+ of AUTOCONF and AUTOM4TE, expected to point respectively to an
+ autoconf and autom4te programs. But while these definitions are
+ honoured in the Automake's build systems and test suite, they
+ were *not* honoured in the generated `automake' and `aclocal'
+ scripts. This behaviour, apart from being wrong in that it does
+ not allow the user enough freedom in choosing his tools, also
+ caused inconsistencies in the test suite, brining to spurious
+ failures.
+ Problem reported by Graham Reitz on the automake list; see thread:
+ <http://lists.gnu.org/archive/html/automake/2011-05/msg00022.html>
+ * automake.in ($traces): Use `@am_AUTOCONF', not simply `autoconf'.
+ * aclocal.in ($traces): Use `@am_AUTOM4TE', not simply `autom4te'.
+ * Makefile.am (do_subst): Substitute also `@am_AUTOCONF' and
+ `@am_AUTOM4TE'.
+ * NEWS: Update.
+ * THANKS: Update.
+
+ 2011-05-29 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ build: the user can override AUTOM4TE, AUTORECONF and AUTOUPDATE too
+ Our build system allows the user to override AUTOCONF and AUTOHEADER
+ at configure time, and honours these overrides in our testsuite.
+ But it didn't do the same with AUTOM4TE, AUTORECONF and AUTOUPDATE.
+ This change fixes that inconsistency.
+ * configure.ac (am_AUTOM4TE, am_AUTOUPDATE, am_AUTORECONF): New
+ AC_SUBSTitutions. Update comments.
+ * tests/defs.in ($AUTOUPDATE): Default to `@am_AUTOUPDATE@' now.
+ ($AUTOM4TE): New variable, defaulting to `@am_AUTOM4TE@'.
+ ($AUTORECONF): New variable, defaulting to `@am_AUTORECONF@'.
+ * doc/Makefile.am ($(srcdir)/amhello-1.0.tar.gz): Update.
+
+ 2011-05-22 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+ Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests/README: fix example about `make -e' usage
+ * tests/README (Section "Writing test cases" subsection "Do"): When
+ some variable is never initialized in the Makefile, `-e' is not
+ necessary in order to override it. DESTDIR is such a variable: we
+ ensure that we do not ever initialize it. And as such, it is quite
+ portable to use:
+ $ make DESTDIR=/foo/bar install
+ and in fact, quite widely used.
+ So our example about when `make -e' is required, which references
+ the `DESTDIR' variable, is poorly chosen, if not downright wrong.
+ Rewrite it to use `prefix' as the overridden variable instead.
+
+ 2011-05-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ parallel-tests: stricter checks on DISABLE_HARD_ERRORS support
+ * tests/parallel-tests-harderror.test: New test, doing more
+ in-depth checks on DISABLE_HARD_ERRORS.
+ * tests/parallel-tests.test: Remove tests on DISABLE_HARD_ERRORS,
+ now redundant.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-05-20 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ testsuite: avoid re-running few tests with 'parallel-tests' option
+ Some tests in our testsuite use the 'simple-tests' driver only
+ marginally, or simply as a mean to conveniently check unrelated
+ invariants. It makes little sense to force these tests to also
+ run with the 'parallel-tests' Automake option active, as doing so
+ offers no real gain in coverage, while often causing a measurable
+ overhead in execution time (for an already too-slow testsuite).
+ * tests/pr401.test (parallel_tests): Define to "no", to prevent
+ the generation of a sibling test script using the 'parallel-tests'
+ driver.
+ * tests/pr401b.test: Likewise.
+ * tests/pr401c.test: Likewise.
+
+ 2011-05-20 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ testsuite: allow tests to avoid the use of 'parallel-tests' option
+ * tests/gen-parallel-tests: Do not generate "siblings" for tests
+ that explicitly define the `parallel_tests', whether to "yes" or
+ to any other value. Extend heading comments to give a rationale
+ for this behaviour.
+ * tests/README: Update.
+
+ 2011-05-20 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests/README: update obsoleted advice
+ * tests/README (Section "Writing test cases" subsection "Do"):
+ Do not suggest to use the `*-p.test' pattern for the names of
+ hand-written tests which use the `parallel-tests' Automake option.
+ Not only is this not respected by the existing tests, but it is
+ more likely to cause conflicts with auto-generated tests.
+ So, suggest to *avoid* using the `*-p.test' pattern in names
+ of hand-written tests instead.
+ (Section "Writing test cases" subsection "Do not"): When
+ suggesting not to override Makefile variables using command
+ line arguments, do not use the badly outdated variables `U'
+ and 'ANSI2KNR' in the example; instead, use the more common
+ and typical `DESTDIR'.
+
+ 2011-05-19 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: rename requirement 'non-cross' -> 'native'
+ * tests/defs.in (non-cross): Rename requirement ...
+ (native): ... to this, which is clearer and fits the
+ existing lingo better.
+ Suggestion by Ralf Wildenhues.
+
+ 2011-05-15 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ testsuite: be more cross-compile friendly
+ * tests/defs.in (cross_compiling): New subroutine.
+ (am__tool_prefix): New internal variable.
+ (gcc, g++, gcj): Force the use of the correct "tool prefix"
+ when cross compiling.
+ (gfortran, g77, non-cross): New requirements.
+
+ 2011-05-11 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ check: document and test $(TEST_SUITE_LOG) overriding
+ * doc/automake.texi (Simple Tests using parallel-tests): Explain
+ how and why TEST_SUITE_LOG can be overridden at runtime.
+ * tests/parallel-tests-log-override-1.test: New test, check that
+ the newly documented idiom and similar usages are truly supported.
+ * tests/parallel-tests-log-override-2.test: Likewise.
+ * tests/parallel-tests-log-override-recheck.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-05-07 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix spurious failure of txinfo21.test on FreeBSD
+ * tests/txinfo21.test: Use the `is_newest' subroutine instead of
+ the `ls -t' hack to to determine whether a file has been updated.
+ This is required because at least FreeBSD `ls' do not sort files
+ with the same timestamp in alphabetical order when using the `-t'
+ option.
+
+ 2011-05-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests defs: allow requirements for compilers (mostly dummy)
+ Most of the new requirements that are now accepted in `$required'
+ as consequence of this patch are still dummy. They are planned
+ to be implemented only in master (or in some derived branch), but
+ having them here (even just as no-op) will allow for an easier
+ integration/backporting of potential new testcases.
+ * tests/defs.in (cc, c++, fortran, fortran77): New requirements,
+ still dummy.
+ (flex): New requirement, picking LEX for configure.
+ (lex): New requirement, alias for `flex'. A more appropriate
+ implementation, looking for a generic `lex' program, will follow
+ in the future.
+ (yacc): New requirement, alias for `bison'. A more appropriate
+ implementation, looking for a generic `yacc' program, will follow
+ in the future.
+
+ 2011-04-24 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix spurious failure in a test on TESTS (VPATH-related)
+ * tests/check-tests-in-builddir.test: When not using the
+ parallel-tests option, do not check that VPATH components are
+ not present in the displayed test name, since the simple-tests
+ driver do not try to strip them.
+
+ 2011-04-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test: self check subroutines for skipping/failing of tests
+ * tests/self-check-report.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-04-23 Jim Meyering <meyering@redhat.com>
+ Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: new subroutines for test skipping/failing
+ * tests/defs.in (Exit): Move definition of this function earlier.
+ (warn_, skip_, fail_, framework_failure_): New functions, inspired
+ to the homonyms in gnulib's tests/init.sh.
+ ($stderr_fileno_): New global variable, used by the new functions
+ above.
+ * tests/README: Updated.
+ From a suggestion by Ralf Wildenhues.
+
+ 2011-04-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix typo (copy & paste blunder) in heading comment
+ * tests/maintclean-vpath.test: Correctly refer to the sister test
+ as `maintclean.test', not as `maintclean-vpath.test'.
+
+ 2011-04-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: remove redundant test `mclean.test'
+ * tests/mclean.test: Remove, it's a weak grepping test completely
+ superseded by the much more complete `maintclean.test'.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-04-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ testsuite: more environment sanitization
+ * tests/defs.in: Sanity check: abort if any of `parallel_tests'
+ or `required' is in the environment.
+ ($sed_unindent_prog): Initialize to empty, to avoid interferences
+ from the environment.
+ * tests/self-check-me-in-env.test: Renamed to ...
+ * tests/self-check-env-sanitize.test: ... this, and extended.
+ * tests/Makefile.am (TESTS): Update.
+ (TESTS_ENVIRONMENT): Unset variables `parallel_tests' and
+ `required'. Adjust comments.
+
+ 2011-04-18 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: don't allow `$me' to be overridden from the environment
+ * tests/defs.in: Sanity check: abort if $me is in the environment.
+ * tests/self-check-me-in-env.test: New test.
+ * tests/Makefile.am (TESTS_ENVIRONMENT): Unset variable `me'.
+ (TESTS): Update.
+ Suggestion by Ralf Wildenhues.
+
+ 2011-04-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: allow overriding of `$me'
+ * tests/defs.in ($me): Allow overriding by the including test
+ script. Add some explicative comments.
+
+ 2011-04-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ depcomp tests: don't reject slower dependency extractors
+ * tests/depcomp8b.test: Add the `--enable-dependency-tracking'
+ option to `configure' invocations, so that slower dependency
+ extractors are not rejected.
+ * tests/depcomp8a.test: Likewise. Also ...
+ (foo.c): ... since we are at it, fix spacing to be consistent
+ with GNU coding standards.
+
+ 2011-04-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ m4: add missing serial numbers to a few files
+ Related to automake bug#8483.
+ * m4/amversion.in: Add serial number.
+ * m4/auxdir.m4: Likewise.
+ * m4/gcj.m4: Likewise.
+ * m4/install-sh.m4: Likewise.
+ * m4/mkdirp.m4: Likewise.
+ * m4/python.m4: Likewise.
+ * m4/runlog.m4: Likewise.
+ * m4/strip.m4: Likewise.
+ * m4/upc.m4: Likewise.
+
+ 2011-04-16 Jim Meyering <meyering@redhat.com>
+
+ depcomp: correct invalid sed invocation
+ * lib/depcomp: Insert missing -e before '/:$/d'.
+ Otherwise, that use of sed would treat '/:$/d' as a file name.
+
+ 2011-04-14 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ maintainer check: quote literal `$' in Makefile rule
+ * Makefile.am (sc_tests_PATH_SEPARATOR): Escape literal `$'
+ character in double-quoted string. Fix a bug in which the rule
+ emitted an erroneously empty substring in its error message.
+
+ 2011-04-12 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ coverage: test for automake bug#8485 (known regression)
+ * tests/yacc-dist-nobuild-subdir.test: New test.
+ * tests/Makefile.am (TESTS, XFAIL_TESTS): Update.
+
+ 2011-04-12 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: define default $distdir (help reducing duplication)
+ * tests/defs.in ($distdir): New variable, might be used in
+ testcases checking distribution-related features.
+ * tests/pr9.test: Use it.
+ * tests/subdir9.test: Likewise.
+ * tests/vtexi3.test: Add comment explaining why we redefine
+ $distdir in this test.
+
+ 2011-04-11 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ depcomp: fix bugs in tests and in the depcomp script
+ * lib/depcomp (gcc): Remove duplicated `-e' from sed invocation.
+ * tests/depcomp10.test: Make it executable. Fix a blunder that
+ has left part of an intended comment not prefixed by `#', thus
+ causing shell syntax errors. In this same comment, break a
+ too-long reported error message on multiple lines, for clarity.
+ Add reference to the relevant bug report. Add a comment which
+ explains why the test result 'skipped' if the first "make" call
+ fails. Add other useful comments.
+ * tests/depcomp9.test: Slightly improve comments.
+
+ 2011-04-11 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Fix hp depmode for VPATH builds with GNU make.
+ * lib/depcomp: Be sure to remove VPATH-prefixed object from
+ dependency output when creating stub rule.
+ * tests/depcomp10.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * NEWS: Update.
+ Report by Bruno Haible.
+
+ 2011-04-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: fix 'javac' requirement for older JDK versions
+ The Java compiler from JDK 1.5 (and presumably earlier versions)
+ cannot handle the `-version' option by itself; and while it does
+ print the version number, it then errors out with an usage error:
+ $ javac -version
+ javac 1.5.0_22
+ javac: no source files
+ Usage: javac <options> <source files>
+ ...
+ Luckily, adding the `-help' option to the `javac' invocation
+ seems to fix this problem.
+ * tests/defs.in (javac): Pass also the `-help' option to the
+ `javac' program. Add a comment explaining why it is needed.
+ Report from Ralf Wildenhues.
+
+ 2011-04-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ test defs: new requirement for the default java compiler
+ * tests/defs.in (for tool in $required): New requirement 'javac'.
+ * tests/java.test: Use it instead of ad-hoc configure check.
+ * tests/java-check.test: Likewise.
+ * tests/instfail-java.test: Likewise.
+ * tests/instdir-java.test: Likewise.
+
+ 2011-04-09 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ java: check_JAVA does not cause compilation by "make all" anymore
+ Fixes automake bug#8234.
+ * automake.in (handle_java): Make stamp of class files built from
+ java sources in $(check_JAVA) a dependency of `check' target, not
+ `all' target.
+ * tests/java-check.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * NEWS: Update.
+ * THANKS: Update.
+ Report from Petteri Räty.
+
+ 2011-04-09 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Clarify regex code in depcomp.
+ * lib/depcomp: Add comment why we don't need regex-escaping here.
+ Suggested by Stefano Lattarini.
+
+ 2011-04-08 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Fix makedepend depmode for VPATH builds.
+ * lib/depcomp [makedepend]: Remove any VPATH prefix from the
+ object file name, so a rebuild doesn't attempt to update the
+ .Po files in the source tree.
+ * tests/depcomp9.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * NEWS: Update.
+
+ 2011-04-02 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix timestamp-related failures
+ Fixes automake bug#8365.
+ * tests/aclocal6.test: Sleep before modifying m4 files that should
+ trigger remake rules. Remove incorrect/obsoleted comments.
+ * tests/subdir5.test: Likewise, and extend a bit.
+ * tests/subdir8.test: Likewise.
+ * tests/pr8365-remake-timing.test: New xfailing test.
+ * tests/Makefile.am (TESTS): Update.
+ Report from Sam Steingold.
+
+ 2011-04-02 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Create subdirs for generated sources even when not dep tracking.
+ * automake.in (handle_single_transform): If $object is derived
+ and lands in subdir, be sure to output a dirstamp dependency.
+ * tests/yacc5.test: Avoid falsely matching the dirstamp
+ dependency when grepping for a rule.
+ * tests/lex-subobj-nodep.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * THANKS: Update.
+ Report by Ignacy Gawedzki.
+
+ Fix locale issue in check-exported-srcdir.test.
+ * tests/check-exported-srcdir.test: Reformulate glob to not fail
+ in a locale that ignores or interleaves character case.
+
+ 2011-04-01 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: better visibility for aclocal in the index
+ * doc/automake.texi (@menu): Rename title for entry 'configure'
+ from "Scanning configure.ac or configure.in" to the more precise
+ "Scanning configure.ac, using aclocal".
+ (@detailmenu): Adjust.
+ (@node configure): Adjust, and extend @cindex calls accordingly.
+ * THANKS: Update.
+ From a report by Maynard Johnson.
+
+ 2011-03-30 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: improve tests on "maintainer-clean" target
+ * tests/aclocal6.test: Move checks related to "maintainer-clean"
+ functionalities into ...
+ * tests/maintclean-vpath.test: ... this new test.
+ * tests/maintclean.test: Update heading comments. Extend to also
+ test subdirs. Remove useless disabling of YACC. Fix m4 quoting
+ in configure.in. Add a trailing `:' command. Remove extra blank
+ lines.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-03-21 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: fix unindent to use printf not echo for script.
+ * tests/defs.in: Use printf rather than echo, as the latter may
+ interpret the backslashes in the sed script. Fixes test
+ failures with dash as /bin/sh.
+
+ 2011-03-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+ Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ maintcheck: look for problematic names of testcases
+ The configure.in stub created by default by `tests/defs' obtains
+ the first argument of AC_INIT from the test name, and this can
+ cause some supported autoconf versions to fail with a spurious
+ error if that test name contains the name of an m4 or m4sugar
+ builtin or macro (e.g., `defn' or `m4_undefine').
+ See for example the bug fixed by commit v1.11-287-g1325a8a.
+ This change add a maintainer check that warns about test names
+ which are possibly problematic in this regard.
+ * Makefile.am (sc_test_names): New maintainer-check target.
+ (syntax_check_rules): Add it.
+ (m4_builtins): New helper variable.
+ (TESTS): Updated according to the following renamings.
+ * tests/include.test: Renamed ...
+ * tests/hdr-vars-defined-once.test: ... to this.
+ * tests/sinclude.test: Renamed ...
+ * tests/m4-inclusion.test: ... to this, and simplified
+ accordingly.
+ * tests/include2.test: Renamed ...
+ * tests/dist-included-parent-dir.test: ... to this, for
+ consistency.
+
+ 2011-03-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix bug in alloca*.test
+ * tests/alloca.test: Make grepping of automake stderr stricter,
+ add a trailing `:' command; also, add AC_PROG_CC to configure.in,
+ and create a dummy alloca.c file, to ensure that we fail for the
+ proper reason.
+ * tests/alloca2.test: Likewise. Also, look for LT_INIT, not
+ AC_PROG_LIBTOOL, in the error message (bug introduced with commit
+ v1.11-315-gd51e7b7 "libtool: suggest LT_INIT if LTLIBRARIES
+ primary is used").
+ From a report by Patrick Welche.
+
+ 2011-03-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix bug (comments-in-var-defn.test + autoconf 2.62)
+ * tests/comments-in-var-defn.test: The configure.in stub created
+ by default, which has the AC_INIT first argument obtained by the
+ test name, causes autoconf 2.62 to fail with a spurious error
+ message like: "configure.in:1: error: defn: undefined macro:".
+ Thus, to prevent this, the test is renamed to ...
+ * tests/comments-in-var-def.test: ... this.
+ * tests/Makefile.am (TESTS): Updated.
+
+ 2011-03-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ cosmetics: convert encoding from ISO-8859 to UTF-8
+ * ChangeLog.03: Convert encoding to UTF-8.
+ * ChangeLog.96: Likewise.
+ * ChangeLog.98: Likewise.
+ * NEWS: Likewise.
+ * TODO: Likewise.
+
+ 2011-03-01 Peter Rosin <peda@lysator.liu.se>
+
+ test defs: unindent without temporary file
+ * tests/defs.in (commented_sed_unindent_prog): Commented Sed program
+ that strips the "proper" amount of leading whitespace.
+ (unindent): Lazily strip comments from the above program and use it
+ to unindent without using a temporary file.
+
+ 2011-02-26 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ libtool: suggest LT_INIT if LTLIBRARIES primary is used
+ When the LTLIBRARIES primary was used, but $(LIBTOOL) wasn't
+ defined, automake suggested to add a call to AC_PROG_LIBTOOL
+ in configure.ac. But that macro is deprecated since Libtool
+ version 1.9b (2004-08-29), in favor of the newer LT_INIT. So
+ suggest the use of this latter macro instead.
+ * lib/Automake/Variable.pm (%_am_macro_for_var): Pair 'LIBTOOL'
+ with 'LT_INIT', not with 'AC_PROG_LIBTOOL'.
+ * tests/libtool4.test: Adjust and extend. Also, add a call to
+ macro AC_PROG_CC in configure.in, to help ensuring that automake
+ does not fail for the wrong reasons.
+ * tests/ltinit.test: New test, ensure that automake's libtool
+ support works with LT_INIT-based interface.
+ Thanks to Jack Kelly for the suggestion.
+
+ 2011-02-20 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: tempdirs with restrictive permissions are cleaned correctly
+ Before this change, the removal of a temporary test directory
+ containing subdirectories with restrictive permissions (such as
+ 'r--r--r--') could fail.
+ * tests/defs: Ensure that all the subdirectories of a temporary
+ test directory have the 'read', 'write' and 'execute' bits set,
+ before trying to remove it with `rm -rf'.
+ * tests/Makefile.am (clean-local-check): Likewise.
+
+ 2011-02-16 Stefano Lattarini <stefano.lattarini@gmail.com>
+ Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ test defs: add subroutine for input unindenting
+ * tests/defs.in (unindent): New subroutine.
+
+ 2011-02-15 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ python: report the 'PYTHON' influential environment variable
+ * m4/python.m4 (AM_PATH_PYTHON): Call AC_ARG_VAR on PYTHON.
+ * doc/automake.texi (Python): Update and extend.
+ * tests/help-python.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * THANKS (Jack Kelly): Update e-mail address.
+ Suggestion by Jack Kelly.
+
+ 2011-02-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests defs: clear TESTS_ENVIRONMENT variable
+ * tests/defs.in (TESTS_ENVIRONMENT): Unset it, so that values
+ from environment won't interfere with the testcases.
+ Suggestion by Ralf Wildenhues.
+
+ 2011-02-06 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: tweak few tests on simple and parallel test drivers
+ * tests/check-exported-srcdir.test: Improve heading comments.
+ * tests/check-tests-in-builddir.test: Likewise. Also, unset the
+ `FOO_EXIT_STATUS' variable, so that any pre-existing value in the
+ environment won't risk to interfere with the test.
+ Suggestions by Ralf Wildenhues.
+
+ 2011-02-01 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ coverage: more tests on simple and parallel test drivers
+ * tests/parallel-tests-subdir.test: New test.
+ * tests/check-exported-srcdir.test: Likewise.
+ * tests/check-tests-in-builddir.test: Likewise.
+ * tests/check-tests_environment.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-01-29 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix spurious failures in lflags*.test
+ * tests/lflags.test: Remove 'LEX' from the environment, so
+ that it won't be erroneously picked up by `make -e'.
+ * tests/lflags2.test: Likewise.
+
+ 2011-01-24 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: color-tests issues with parallel make
+ * doc/automake.texi (Simple Tests): Document that automatic
+ recognition of a capable terminal attached to stdout can fail
+ with some make implementation when running in parallel mode,
+ thus causing colored test output not to be automatically
+ activated when it should.
+
+ 2011-01-23 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: avoid instspc.test failures due to make's whitespace trimming
+ * tests/instspc.test: Prepend './' when passing the test
+ characters, to avoid leading whitespace characters to be trimmed
+ from macros set from environment variables. Fixes testsuite
+ failures with HP-UX, IRIX, and Tru64/OSF make.
+
+ 2011-01-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ coverage: test semantics of "dummy" per-target flags
+ * tests/specflg-dummy.test: New test, ensuring that even "dummy"
+ per-target flags triggers the use of renamed objects.
+ * tests/Makefile.am (TESTS): Update.
+ Suggestion by Ralf Wildenhues.
+
+ 2011-01-23 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests defs: sanitize IFS
+ * tests/defs.in ($IFS): Define to <space>, <tab>, <newline>.
+ ($sp): New variable, holding a single whitespace character.
+ ($tab): New variable, holding a tabulation character.
+ ($nl): New variable, holding a newline character.
+
+ 2011-01-22 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: fix VPATH auto-expansion workarounds.
+ * tests/parallel-tests8.test, tests/suffix13.test:
+ Ensure $< is not surrounded by white space, to prevent Solaris
+ make from applying automatic VPATH text expansion.
+
+ 2011-01-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix spurious failures in yflags*.test
+ * tests/yflags.test: Remove 'YACC' from the environment, so
+ that it won't be erroneously picked up by `make -e'.
+ * tests/yflags2.test: Likewise.
+
+ 2011-01-22 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: avoid fn99*.test failures due to buggy AIX 5.3 cp -R.
+ * tests/fn99.test, tests/fn99subdir.test: Skip if an initial
+ `cp -R' of the subdir tree already fails; AIX 5.3 cp messes
+ up its internal memory when copying this tree.
+
+ 2011-01-22 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+ Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Add comment to check-TESTS rule working around make 3.80 bug.
+ * lib/am/check.am (check-TESTS): Update comment.
+
+ 2011-01-20 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: less strict double-colon spy.test again.
+ * tests/spy.test: We know BSD make doesn't invoke more than one
+ double-colon rule, so no need to expose that failure.
+
+ 2011-01-19 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ install-sh: avoid Tru64 sh `test' operator precedence issues.
+ * lib/install-sh: Protect file names and directory components
+ that consist of `=', `(', `)', or `!'. Move protection as early
+ as possible, to avoid errors such as with Tru64 sh `test -z ='.
+ * tests/instsh2.test: Extend test to cover more possibilities.
+ Fixes 1.12 instspc-equal-install.test failure on Tru64/OSF 5.1.
+
+ 2011-01-19 Stefano Lattarini <stefano.lattarini@gmail.com>
+ Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ docs: automake testsuite doesn't use TESTS_ENVIRONMENT anymore
+ * doc/automake.texi (Simple Tests): Do not claim Automake uses
+ TESTS_ENVIRONMENT for the perl driver. Instead, point to the
+ parallel-tests driver.
+
+ 2011-01-19 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Allow _AM_DEPENDENCIES to be used later in configure.
+ * m4/depend.m4 (_AM_DEPENDENCIES): Remove a previously existing
+ conftest.dir before recreating it.
+ Fixes bug#7864.
+ Report by Eric Blake, from report by Scott McCreary against M4.
+
+ 2011-01-18 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: avoid failure on w32 file systems.
+ * tests/parallel-tests-unreadable-log.test: SKIP if file cannot
+ be turned unreadable.
+
+ 2011-01-17 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: allow double-colon spy.test to work with HP-UX make.
+ * tests/spy.test: Fix comment typos. Ensure prerequisites we
+ do not want to depend on are strictly older than the target.
+ Also test with a target out of date wrt. more than one rule.
+
+ 2011-01-16 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: remove useless requirements from cond36.test
+ * tests/cond36.test ($required): Remove.
+ Since we are at it, add a trailing `:' command.
+
+ 2011-01-16 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+ Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ parallel-tests: work around Tru64/OSF 5.1 sh read bugs.
+ * lib/am/check.am ($(TEST_SUITE_LOG), recheck, recheck-html):
+ Test file readability before redirecting input from it, to avoid
+ exiting Tru64/OSF 5.1 sh which treats read as special builtin.
+ * tests/parallel-tests-unreadable-log.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+ * NEWS: Update.
+
+ 2011-01-16 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ * NEWS, README: Update copyright years.
+
+ Fix parallel-tests.test failure with HP-UX make.
+ * tests/parallel-tests.test: Sleep inside inner tests, so logs
+ are newer than logs of tests they depend on, for HP-UX make.
+
+ 2011-01-15 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ docs: ensure example are separated with empty lines in the input
+ * doc/automake.texi (Extending aclocal, Emacs Lisp, Rebuilding)
+ (API Versioning, Renamed Objects, Multiple Outputs): Add empty
+ lines before `@example' and after `@end example' lines, so info
+ output is rendered correctly, and a following @noindent honored.
+ Report by Stefano Lattarini.
+
+ 2011-01-15 Jim Meyering <meyering@redhat.com>
+
+ tests: fix comment typo
+ * tests/substref.test: Fix grammar in a comment.
+
+ 2011-01-13 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: fix spurious failures in two texinfo tests
+ * tests/txinfo.test ($required): Add 'makeinfo'.
+ * tests/txinfo8.test: Create a dummy 'textutils.info' file, so
+ that make won't try to run makeinfo (which could be unavailable)
+ to build it.
+ Found by NixOS Hydra, reported by Ralf Wildenhues.
+
+ 2011-01-13 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Avoid testsuite failures due to Autoconf Fortran change.
+ Autoconf v2.68-21-g727ce95 causes AC_F77_LIBRARY_LDFLAGS to
+ require computing the canonical host name. Ensure config.guess
+ and config.sub files are present for respective checks.
+ * tests/compile_f_c_cxx.test: Add stub files.
+ * tests/flibs.test: Likewise.
+ * tests/fort4.test: Use $AUTOMAKE -a for installing files.
+
+ 2011-01-12 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: clustered '-d' not recognized in YFLAGS
+ This change fixes automake bug#7828.
+ * doc/automake.texi (Yacc and Lex): Document that automake
+ recognizes '-d' in AM_YFLAGS only if it's not clustered with
+ other options.
+ From a report by Юрий Пухальский.
+
+ 2011-01-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: add checks on automatically-distributed files
+ Related to automake bug#7819.
+ * tests/autodist.test: New test.
+ * tests/autodist-subdir.test: Likewise.
+ * tests/autodist-acconfig.test: Likewise.
+ * tests/autodist-acconfig-no-subdir.test: Likewise.
+ * tests/autodist-aclocal-m4.test: Likewise.
+ * tests/autodist-config-headers.test: Likewise.
+ * tests/autodist-configure-no-subdir.test: Likewise.
+ * tests/autodist-stamp-vti.test: Likewise.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2011-01-11 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ tests: work around a texi+cygnus bug causing a spurious XFAIL
+ * tests/txinfo5b.test: New test, like txinfo5.test but calling
+ automake with the `-Wno-override' option to work around a bug
+ in the texinfo + cygnus interaction.
+ * tests/txinfo5.test: Update heading comments.
+ * tests/Makefile.am (TEST): Updated.
+
+ 2011-01-09 Dave Hart <davehart@gmail.com> (tiny change)
+
+ Fix another typo in Rule.pm comment.
+ * lib/Automake/Rule.pm: Fix typo.
+
+ 2011-01-11 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Improve, extend and tweak tests on Texinfo support.
+ * tests/instdir-texi.test: Add a call to `ls -l' after that to
+ `make', for debugging. When looking for required tools, do not
+ redirect the output of "$tool --help" to /dev/null, and do not
+ uselessly run it in a subshell.
+ * tests/txinfo.test: Rewritten to run autoconf, ./configure and
+ make. All checks moved into Makefile.am.
+ * tests/txinfo8.test: Likewise, and modernize the generated
+ configure.in.
+ * tests/txinfo2.test: Moved checks into Makefile.am, and other
+ minor improvements.
+ * tests/txinfo5.test: Enable `errexit' shell flag, and related
+ changes. Add trailing `:' command.
+ * tests/txinfo6.test: Likewise, and make grepping of generated
+ Makefile.in stricter.
+ * tests/txinfo7.test: Enable `errexit' shell flag, and related
+ changes. Add trailing `:' command. Do not add unnecessary stuff
+ to Makefile.am.
+ * tests/txinfo9.test: Verify that more targets which are expected
+ to be generated only once really are. Make grepping less strict,
+ to avoid exposing too much internal details. More minor changes.
+ * tests/txinfo16.test: Add trailing `:'. Prefer cat over echo
+ for appending to configure.in. Updated/fixed heading comments.
+ * tests/txinfo23.test: Likewise, and extended a little by making
+ it check that no info file is created in the $(srcdir).
+ * tests/txinfo24.test: Likewise.
+ * tests/txinfo25.test: Likewise.
+ * tests/txinfo18.test: Add trailing `:'. Prefer cat over echo
+ for appending to configure.in. Also, check that index files are
+ cleaned also by "make clean", not only by "make distclean".
+ * tests/txinfo22.test: Prefer `$me' over hard-coded test name,
+ and added trailing `:' command. This testcase also used to check
+ that automake ignores in-line comments when using variables, but
+ preserves them in the output; these checks (added in commit
+ "Release-1-7f-4-g9177ef8") do not really pertain to this test,
+ so they have been moved ...
+ * tests/comments-in-var-defn.test: ... into this new test.
+ * tests/txinfo4.test: Escape literal dots in grep regexps. Add
+ trailing `:' command.
+ * tests/txinfo29.test: Likewise. Relax grepping of generated
+ Makefile.in w.r.t. whitespaces. Prefer `cat' over `echo' to
+ append to configure.in.
+ * tests/txinfo3.test: Likewise.
+ * tests/vtexi.test: Improve grepping of Makefile.in (sometimes
+ make it stricter, sometimes laxer). Move `set -e' setting just
+ after the inclusion of ./defs. De-uglify a sed command. Other
+ minor cosmetic improvements.
+ * tests/vtexi2.test: Make grepping of Makefile.in stricter. Add
+ trailing `:' command.
+ * tests/vtexi3.test: New test on version.texi support.
+ * tests/vtexi4.test: Likewise.
+ * tests/Makefile.am (TESTS): Updated.
+
+ 2011-01-09 Peter Rosin <peda@lysator.liu.se>
+
+ Fix another typo in Rule.pm comment.
+ * lib/Automake/Rule.pm: Fix typo.
+
+ 2011-01-09 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ cosmetics: remove trailing whitespaces
+ * doc/automake.texi: Remove trailing whitespaces.
+ * tests/cond13.test: Likewise.
+ * tests/cond14.test: Likewise.
+ * tests/fort4.test: Likewise.
+ * tests/fort5.test: Likewise.
+ * tests/suffix7.test: Likewise.
+ * tests/vtexi2.test: Likewise.
+
+ automake: minor fixes in comments
+ * automake.in: Some minor fixes and enhancements in comments.
+
+ 2011-01-09 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Add test coverage for deleted header files.
+ * tests/depcomp6.test, tests/depcomp7.test: Update tests to
+ also check for the deleted header bug. If no dependency
+ tracking mechanism could be found, SKIP rather than exit
+ successfully. Use GNU style spacing and ANSI C prototypes.
+
+ Fix typos in Rule.pm comments.
+ * lib/Automake/Rule.pm: Fix typos in comments.
+
+ docs: split 'amhello Explained' node.
+ * doc/automake.texi (amhello Explained): Split node ...
+ (amhello's configure.ac Setup Explained)
+ (amhello's Makefile.am Setup Explained) : ... into these two.
+ (Top, Hello World): Adjust, and add @anchor for stable URL links.
+ Suggestion by Karl Berry in automake bug#7766.
+
+ 2011-01-08 Karl Berry <karl@freefriends.org>
+ Eric Blake <eblake@redhat.com>
+
+ docs: reference defining directories in amhello node.
+ * doc/automake.texi (amhello Explained): Point to Autoconf
+ manual for how to convert directory values into macros.
+ (Optional): Fix grammar nit.
+
+ 2011-01-02 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ * NEWS: Fix typo (forgotten word).
+
+ 2011-01-02 Stefano Lattarini <stefano.lattarini@gmail.com>
+ Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ docs: how to work around checks on invalid primary/directory couples
+ * doc/automake.texi (Uniform): Document the blessed idiom which can
+ be used to work around automake checks on invalid primary/directory
+ couples (such as `lib_PROGRAMS' or `doc_LIBRARIES').
+
+ 2011-01-02 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Sync auxiliary files from upstream.
+ * lib/config.guess, lib/config.sub, lib/texinfo.tex:
+ Sync from upstream.
+
+ Fix maintainer-check regression.
+ * tests/subobj11a.test: Pass DISTCHECK_CONFIGURE_FLAGS in the
+ environment.
+
+ Bump copyright years.
+ * aclocal.in (write_aclocal, version): Bump copyright years.
+ * automake.in (gen_copyright, version): Likewise.
+ * doc/automake.texi: Likewise.
+
+ 2010-12-23 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+ Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Work around a bug in file-inclusion mechanism of Solaris make.
+ * automake.in (handle_single_transform): In the name of the
+ dependency file: collapse multiple slash characters into a single
+ one.
+ * tests/subobj11a.test: New test.
+ * tests/subobj11b.test: Likewise.
+ * tests/subobj11c.test: Likewise.
+ * tests/depcomp8a.test: Likewise.
+ * tests/depcomp8b.test: Likewise.
+ * tests/Makefile.am (TESTS): Updated.
+ * NEWS: Updated.
+ Report by Stefano Lattarini, quick fix by Ralf Wildenhues, final
+ patch and tests by Stefano Lattarini.
+
+ 2010-12-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix two spurious testsuite failures on IRIX 6.5.
+ * tests/suffix13.test (Makefile.am): Account for VPATH issues on
+ weaker make implementations (e.g. IRIX 6.5).
+ * tests/parallel-tests8.test: Likewise, plus a required related
+ change.
+ Reported by Ralf Wildenhues. The bugs have been there from the
+ first versions of the affected test scripts.
+
+ 2010-12-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: cygnus mode doesn't require AM_CYGWIN32 macro.
+ * doc/automake.texi (Cygnus): Mode 'cygnus' does not require
+ the AM_CYGWIN32 macro (and indeed hasn't required it since at
+ least commit Release-1-2-31-g3038064 "merged changes from
+ Cygnus" of 1997-08-25).
+
+ 2010-12-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ distlinksbrk.test: Work around botched "make -k".
+ * tests/distlinksbrk.test: Run "make" multiple times and grep
+ its output each time for a single error message, rather than
+ running "make -k" one single time and grepping its output for
+ all the expected error messages. This should work around make
+ implementations with limited (broken?) `-k' support; for more
+ information, see these subthreads on the automake-patches list:
+ - 2010-11-15, "Testsuite failures on HP-UX 11.23",
+ <http://lists.gnu.org/archive/html/automake-patches/2010-11/msg00162.html>
+ - 2010-11-15, "Testsuite failures on IRIX 6.5",
+ <http://lists.gnu.org/archive/html/automake-patches/2010-11/msg00166.html>
+
+ 2010-12-21 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix sed-related buglet in test "subdir5.test"
+ * tests/subdir5.test: Always terminate text passed to the
+ `i' sed command with a newline, to work around limitations
+ in e.g. older OpenBSD sed.
+
+ 2010-12-18 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: fix blunder in example about python extension modules
+ * doc/automake.texi (Python): Use `quaternion_la_SOURCES',
+ not `quaternion_SOURCES', to declare the sources of python
+ extension module `quaternion.la'.
+
+ 2010-12-16 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ docs: list LTLIBRARIES among Automake primaries
+ * doc/automake.texi (Uniform): List `LTLIBRARIES' among
+ the Automake primaries.
+
+ 2010-12-14 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Improve tests on generated portions of configure help screen.
+ * tests/help-depend.test: Grepping of configure help screen
+ relaxed to cater for possible line wrapping, and tightened in
+ other respects.
+ * tests/help-depend2.test: Likewise.
+ * tests/help-dmalloc.test: Likewise.
+ * tests/help-lispdir.test: Likewise.
+ * tests/help-maintainer.test: Likewise.
+ * tests/help-multilib.test: Likewise.
+ * tests/help-silent.test: Likewise.
+ * tests/help-upc.test: Likewise.
+ * tests/help-init.test: Grepping of configure help screen
+ tightened.
+
+ 2010-12-10 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Avoid running installed automake from 'libtool --help'.
+ * tests/subobj9.test: Export AUTOCONF and AUTOMAKE.
+ Together with fixed Libtool, this fixes check-coverage to not
+ invoke installed automake.
+
+ 2010-11-25 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix spurious failures in `silent*.test' for $CC != gcc
+ In some tests on automake-produced silent rules, we forced the
+ use of gcc depmode to improve testsuite coverage; but this has
+ unsurprisingly led to spurious failures when some non-GNU C
+ compilers were used. So we are now careful to require GCC in
+ tests that force gcc depmode.
+ From reports by Ralf Wildenhues.
+ * tests/silent5.test: Test removed, its content split into ...
+ * tests/silent-many-generic.test, tests/silent-many-gcc.test: ...
+ these new sister tests, the latter of which forces gcc depmode
+ and lists "gcc" in $required.
+ * tests/silentlex.test: Test removed, its content split into ...
+ * tests/silent-lex-generic.test, tests/silent-lex-gcc.test: ...
+ these new sister tests, the latter of which forces gcc depmode
+ and lists "gcc" in $required.
+ * tests/silentyacc.test: Test removed, its content split into ...
+ * tests/silent-yacc-generic.test, tests/silent-yacc-gcc.test: ...
+ these new sister tests, the latter of which forces gcc depmode and
+ lists "gcc" in $required.
+ * tests/Makefile.am (TESTS): Updated.
+
+ 2010-11-21 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Tests: consistently use "|| Exit 1" after ". ./defs".
+ * tests/autohdr.test: Use `. ./defs || Exit 1', not bare
+ `. ./defs', for consistency with other tests.
+ * tests/autohdr2.test: Likewise.
+ * tests/autohdr3.test: Likewise.
+ * tests/autohdr4.test: Likewise.
+ * tests/cond23.test: Likewise.
+ * tests/cond24.test: Likewise.
+ * tests/cond25.test: Likewise.
+ * tests/cond26.test: Likewise.
+ * tests/cond27.test: Likewise.
+ * tests/cond28.test: Likewise.
+ * tests/cond29.test: Likewise.
+ * tests/cond30.test: Likewise.
+ * tests/cond31.test: Likewise.
+ * tests/cond32.test: Likewise.
+ * tests/cond33.test: Likewise.
+ * tests/cond34.test: Likewise.
+ * tests/cond35.test: Likewise.
+ * tests/cond36.test: Likewise.
+ * tests/cond37.test: Likewise.
+ * tests/cond38.test: Likewise.
+ * tests/cond39.test: Likewise.
+ * tests/cond40.test: Likewise.
+ * tests/cond41.test: Likewise.
+ * tests/cond42.test: Likewise.
+ * tests/cond43.test: Likewise.
+ * tests/cond44.test: Likewise.
+ * tests/cond45.test: Likewise.
+ * tests/dollarvar.test: Likewise.
+ * tests/dollarvar2.test: Likewise.
+ * tests/hfs.test: Likewise.
+ * tests/libobj14.test: Likewise.
+ * tests/percent.test: Likewise.
+ * tests/percent2.test: Likewise.
+ * tests/phony.test: Likewise.
+ * tests/silent.test: Likewise.
+ * tests/silent2.test: Likewise.
+ * tests/silent3.test: Likewise.
+ * tests/silent4.test: Likewise.
+ * tests/silent5.test: Likewise.
+ * tests/silent6.test: Likewise.
+ * tests/silent7.test: Likewise.
+ * tests/silent9.test: Likewise.
+ * tests/silentcxx.test: Likewise.
+ * tests/silentf77.test: Likewise.
+ * tests/silentf90.test: Likewise.
+ * tests/silentlex.test: Likewise.
+ * tests/silentyacc.test: Likewise.
+
+ Avoid useless cleaning in some `silent*.test' tests.
+ * tests/silentf77.test: Removed useless calls to "make clean"
+ and "make maintainer-clean".
+ * tests/silentf90.test: Likewise.
+ * tests/silent3.test: Removed useless call to "make distclean".
+ * tests/silent4.test: Likewise.
+ * tests/silent9.test: Likewise.
+
+ 2010-11-19 Ian Lance Taylor <iant@google.com>
+
+ Sync config-ml.in from GCC.
+ * config-ml.in: Add Go support: treat GOC and GOCFLAGS like other
+ compiler/flag environment variables.
+
+ 2010-11-19 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Automake::Config: remove extra trailing semicolon.
+ * lib/Automake/Config.in: Remove extra trailing semicolon.
+
+ help4.test: fix botched heading comment.
+ * tests/help4.test: Fixed the heading comment, since it
+ didn't correctly describe what checks the testcase was
+ supposed to perform.
+
+ help2.test: add checks on aclocal too.
+ * tests/help2.test: Check that also `aclocal --version' and
+ `aclocal --help' work with configure.in and acinclude.m4 both
+ broken.
+
+ 2010-11-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix spurious failures of silent-rules tests with Sun Fortran.
+ * tests/silentf77.test: Strip from the make output some verbose
+ messages possibly printed by the SunStudio fortran compilers, to
+ avoid spurious failures. Add a trailing `:' command.
+ * tests/silentf90.test: Likewise.
+
+ 2010-11-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix spurious failures of silent5.test with Sun Fortran.
+ * tests/silent5.test: Strip from the make output some verbose
+ messages possibly printed by the SunStudio fortran compilers,
+ to avoid spurious failures. This bug has been there from the
+ very first version of this test script.
+
+ 2010-11-16 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix regression in colon{5,6}.test (failures on AIX 5.3).
+ * tests/colon5.test: Also substitute `@SHELL@' with `$SHELL' when
+ post-processing the generated Makefile.in, to work around a bug
+ of AIX 5.3 make which doesn't allow setting the `$(SHELL)' macro
+ on the commend line. Calls to `$MAKE' adjusted accordingly.
+ * tests/colon6.test: Likewise.
+ Regression introduced in commit v1.11-175-gf9fe878 "Modernize,
+ improve and/or extend tests `colon*.test", and reported by Ralf
+ Wildenhues.
+
+ 2010-11-16 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix regression in ansi.test (failure on AIX 5.3).
+ * tests/ansi.test: Remove redundant hackish check done using a
+ hand-postprocessed Makefile.in. This check worked by setting
+ the `$(SHELL)' macro on the command line of make, but this is
+ not supported by the AIX 5.3 make implementation.
+ This bug has been lurking for a long time, and was activated by
+ commit v1.11-125-gc1f6cdb "Enable `errexit' shell flag in various
+ tests". Report by Ralf Wildenhues.
+
+ 2010-11-16 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: avoid '##'-style comments inside recipe commands.
+ * tests/confh.test, tests/confh8.test: Remove
+ double-hash comments from makefile rule commands, they
+ are not part of the Automake API.
+
+ 2010-11-14 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: work around dash quoting issue in case statements.
+ * tests/color.test, tests/color2.test: Quote variable in case
+ pattern, to avoid skipping tests with dash 0.5.5.1.
+
+ 2010-11-14 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Rebuild menus in the manual.
+ * doc/automake.texi: Rebuild menus (using ^C ^U ^A in emacs).
+ Thanks to Ian Lance Taylor for the suggestion.
+
+ Fix install-strip when $(STRIP) contains several words.
+ * lib/am/install.am (install-strip): Update comment. Use
+ separate sub-make invocations for empty and nonempty $(STRIP),
+ to fix quoting issues.
+ * tests/strip2.test, tests/strip3.test: New tests.
+ * tests/Makefile.am (TESTS): Adjust.
+
+ 2010-11-10 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Fix yaccdry.test failure: require bison.
+ * tests/yaccdry.test: Require bison.
+ Found by NixOS Hydra.
+
+ 2010-11-07 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix a bug in variable concatenation with `+='.
+ * lib/Automake/VarDef.pm (append): Since the content of the
+ "appended-to" variable is going to be unconditionally normalized
+ later, simply separate the appended value with a single whitespace
+ character, instead of trying to be uselessly smarter by using
+ escaped newlines. This fixes a bug in which extra backslashes
+ where erroneously inserted in the variable's final value.
+ * tests/pluseq11.test: New test, exposing the bug.
+ * tests/Makefile.am (TESTS): Update.
+ Reported by Andy Wingo.
+
+ 2010-11-06 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix bug in rules for creating vala vapi/header files.
+ * automake.in (lang_vala_finish_target): Add forgotten "fi" in an
+ if control structure in a generated make rules. Bug introduced
+ by previous commit `v1.11-221-gd7c1679', and revealed by failure
+ of test `vala2.test'.
+
+ 2010-11-01 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Fix and document rules to not touch the tree with `make -n'.
+ * doc/automake.texi (Multiple Outputs): Document the problem of
+ modifications during dry-run execution, propose solution.
+ * NEWS: Update.
+ * automake.in (lang_vala_finish_target): Split recipe so the
+ stamp file is not removed with GNU `make -n'.
+ (lang_yacc_target_hook): Separate removal of parser output file
+ and header remaking.
+ * lib/am/lisp.am ($(am__ELCFILES)): Determine whether -n was
+ passed to make, take care not to remove any files in that case.
+ * lib/am/remake-hdr.am (%CONFIG_H%): Separate removal of
+ %STAMP% file from induced remaking of config header.
+ * tests/autohdrdry.test, tests/lispdry.test, tests/yaccdry.test:
+ New tests.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2010-11-01 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Add FAQ entry for bug reporting instructions.
+ * doc/automake.texi (Reporting Bugs): New section.
+ (Introduction): Refer to it.
+
+ 2010-10-04 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Add support for newer python versions.
+ * m4/python.m4 (AM_PATH_PYTHON): Add python2.7 and python3.2 to
+ _AM_PYTHON_INTERPRETER_LIST. Since we are at it, break a long
+ line and fix indentation.
+ * THANKS: Updated.
+ From a report by Thomas Klausner.
+
+ Add test for `AM_WITH_DMALLOC' macro.
+ * tests/dmalloc.test: New test.
+ * tests/Makefile.am (TESTS): Update.
+
+ Fix nits and bugs in tests `help*.test'.
+ * tests/help4.test: Fix broken sed commands used to strip `-W...'
+ flags away from "$AUTOMAKE" and "$ACLOCAL".
+ * tests/help3.test: Likewise, and fix a botched comment.
+ * tests/help.test: Likewise. Also, use "AUTOMAKE_fails ..."
+ instead of "$AUTOMAKE ... && Exit 1", for consistency and to
+ please maintainer-check.
+ * tests/help2.test: Likewise.
+
+ 2010-10-03 Stefano Lattarini <stefano.lattarini@gmail.com>
+ Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Improve tests `help*.test' (also fixes maintcheck failures).
+ * tests/help.test: To run automake, use `$AUTOMAKE' with all `-W'
+ flags stripped away rather than hard-coded `automake-$APIVERSION',
+ to better honour user-overrides. Similarly for aclocal.
+ * tests/help2.test: Likewise.
+ * tests/help3.test: Likewise.
+ * tests/help4.test: Likewise.
+
+ 2010-10-03 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Document and fix expansion of variables before rules.
+ * doc/automake.texi (General Operation): Document that variables
+ are expanded before rules.
+ * lib/am/check.am (am__check_post): Reword a bit so it does not
+ get matched as a rule.
+ Suggestion by Ben Pfaff.
+
+ 2010-10-02 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Revert "parallel-tests: avoid command-line length limit issue."
+ This reverts commit 24e3b4ee2f8cb9f72dd94a05a893f3d4e88b7835,
+ because it re-opened the bug fixed by v1.11-10-g218e678.
+
+ 2010-09-07 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ parallel-tests: avoid command-line length limit issue.
+ * automake.in (handle_tests): New argument $makefile, new
+ substitution %MAKEFILE%.
+ (generate_makefile): Adjust.
+ * lib/am/check.am [%?PARALLEL_TESTS%] (check-TESTS): Pass
+ sanitized TEST_LOGS value as makefile snippet on standard
+ input to $(MAKE), to avoid exceeding the command line limit on
+ w32 (MSYS).
+ * NEWS: Update.
+ Report by Bob Friesenhahn.
+
+ 2010-09-26 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Extend tests on `--help' and `--version' options.
+ * tests/help.test: Create a new empty directory and chdir into
+ it, rather than removing already present files. Run the aclocal
+ and automake wrapper scripts directly, instead of relying on
+ $AUTOMAKE and $ACLOCAL. Be sure to correctly match literal dots
+ in aclocal's and automake's stderr. Add a trailing `:' command.
+ * tests/help2.test: New test, checking that options `--help' and
+ `--version' works in directories with broken `configure.in'.
+ * tests/help3.test: New test, checking that options `--help' and
+ `--version' take precedence on the other options.
+ * tests/help4.test: New test, checking that the first among the
+ `--help' and `--version' options to be specified on the command
+ line wins.
+ * tests/Makefile.am (TESTS): Updated.
+
+ 2010-09-25 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Testsuite: Use `$PATH_SEPARATOR', not `:', when extending PATH.
+ * tests/compile2.test: Do no uselessly (implicitly) repeat the
+ computation of PATH_SEPARATOR again.
+ * tests/instmany-mans.test: Use `$PATH_SEPARATOR', not `:', when
+ extending/redefining PATH.
+ * tests/instmany-python.test: Likewise.
+ * tests/instmany.test: Likewise.
+ * tests/man4.test: Likewise.
+ * tests/mkinst3.test: Likewise.
+ * tests/mmodely.test: Likewise.
+ * tests/multlib.test: Likewise.
+ * tests/txinfo30.test: Likewise.
+ * tests/README (Section "Writing test cases" subsection "Do"):
+ Updated.
+ * Makefile.am (sc_tests_PATH_SEPARATOR): New maintainer check.
+ (syntax_check_rules): Updated.
+
+ Testsuite: new variables `$PATH_SEPARATOR' and `$APIVERSION'.
+ * tests/defs.in ($APIVERSION): New AC_SUBST'd variable.
+ ($ACLOCAL, $AUTOMAKE): Use it.
+ ($PATH_SEPARATOR): New AC_SUBST'd variables.
+ ($PATH): Use it.
+
+ 2010-09-22 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Manual: be more agnostic w.r.t. version control system used.
+ * doc/automake.texi (Basics of Distribution): Also refer to `.svn'
+ directories as a type of probably-unwanted files that are copied
+ regardless when adding directories to EXTRA_DIST.
+ (The dist Hook): Show a dist-hook example which removes Subversion
+ `.svn' private directories from distdir, rather than CVS private
+ directories.
+ (missing and AM_MAINTAINER_MODE): Try to be more agnostic w.r.t.
+ the version control system used.
+
+ Manual: index refer to target "git-dist", not "cvs-dist".
+ * doc/automake.texi (General Operation): Index the non-standard
+ example about "git-dist" under the "git-dist" label, not under
+ the "cvs-dist" one.
+
+ Perl modules: remove references to "Automake CVS repository".
+ * lib/Automake/Channels.pm: Update comments to refer to "Automke's
+ git repository" rather than to "Automake's CVS repository".
+ * lib/Automake/Configure_ac.pm: Likewise.
+ * lib/Automake/FileUtils.pm: Likewise.
+ * lib/Automake/Struct.pm: Likewise.
+ * lib/Automake/XFile.pm: Likewise.
+ * lib/Automake/Version.pm (=head1 DESCRIPTION): Refer to "git
+ branches" rather than "CVS branches".
+
+ Remove obsolete .cvsignore files.
+ * .cvsignore, doc/.cvsignore, lib/.cvsignore, lib/am/.cvsignore,
+ lib/Automake/.cvsignore, lib/Automake/tests/.cvsignore,
+ m4/.cvsignore, tests/.cvsignore: Files deleted. Even when using
+ savannah's CVS readonly mirror there's no way to commit back to
+ the real repository, so this files are not worth maintaining or
+ keeping around.
+
+ 2010-09-21 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ * m4/dmalloc.m4: Bump serial number and copyright years.
+
+ 2010-09-20 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix broken link in `AM_WITH_DMALLOC' help screen.
+ * m4/dmalloc.m4 (AM_WITH_DMALLOC): Refer only to the dmalloc site
+ `http://www.dmalloc.com', not to the dmalloc tarball there (which
+ seems to have been removed, substituted by multiple release
+ tarballs now).
+
+ 2010-09-17 Eric Blake <eblake@redhat.com>
+
+ Avoid triple-space after period.
+ * automake.in (handle_single_transform): Avoid 3 spaces at
+ sentence end.
+ * ChangeLog.03: Likewise.
+ * lib/Automake/ChannelDefs.pm: Likewise.
+ * lib/Automake/Channels.pm (_print_message): Likewise.
+ * lib/Automake/Rule.pm (rule): Likewise.
+ * lib/Automake/Variable.pm (var): Likewise.
+ * lib/am/distdir.am: Likewise.
+ * tests/insthook.test: Likewise.
+
+ 2010-09-15 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Test automake-generated portions of configure help screen.
+ * tests/help-depend.test: New test.
+ * tests/help-depend2.test: Likewise.
+ * tests/help-dmalloc.test: Likewise.
+ * tests/help-init.test: Likewise.
+ * tests/help-lispdir.test: Likewise.
+ * tests/help-maintainer.test: Likewise.
+ * tests/help-multilib.test: Likewise.
+ * tests/help-regex.test: Likewise.
+ * tests/help-silent.test: Likewise.
+ * tests/help-upc.test: Likewise.
+ * tests/mmode.test: Remove tests on `configure --help' output,
+ they are superseded by tests in `help-maintainer.test'.
+ * tests/Makefile.am (TESTS): Update.
+
+ 2010-09-14 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ * tests/README: Don't put GCS mandated tools in $required.
+
+ 2010-09-13 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ * HACKING: Hint at old commits with `git describe' output.
+
+ 2010-09-12 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix regression in test `colon4.test'.
+ * tests/colon4.test: Fix botched editing to `configure.in'
+ that made the test useless. Since we are at it, improve
+ comments and make grepping of generated Makefile.in slightly
+ stricter.
+ Regression introduced by change "Modernize, improve and/or
+ extend tests `colon*.test" (Stefano Lattarini, 2010-08-08).
+
+ 2010-09-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Do not require "gzip" explicitly in tests.
+ The gzip utility is simply expected to be present on any decent
+ target system for Automake. So it's pointless to put it in
+ $required.
+ * tests/install2.test ($required): Do not require "gzip".
+ * tests/lex3.test: Likewise.
+ * tests/pr9.test: Likewise.
+ From a suggestion by Ralf Wildenhues.
+
+ Make some `confh*.test' tests more "semantic" (plus tweakings).
+ * tests/confh.test: Run "autoconf", "configure" and "make check",
+ instead of munging/grepping the generated `Makefile.in'.
+ * tests/confh4.test: Relax the grepping of Makefile.in w.r.t.
+ white spaces. Do not create useless dummy source file `foo.c'
+ and useless dummy header file `acconfig.h'.
+ (configure.in): Remove superfluous call to `AC_OUTPUT'.
+ * tests/confh6.test: Add trailing `:' command.
+ * tests/confh7.test: In comments, add reference to ...
+ * tests/confh8.test: ... this new test, "semantic" sister
+ of `confh7.test'.
+ * tests/Makefile.am (TESTS): Updated.
+ Prompted by a report from Ralf Wildenhues.
+
+ Remove useless whitespace padding in XFAIL_TESTS definition.
+ * tests/Makefile.am (XFAIL_TESTS): Remove whitespace padding.
+
+ 2010-09-07 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ parallel-tests: avoid command-line length limit issue.
+ * automake.in (handle_tests): New argument $makefile, new
+ substitution %MAKEFILE%.
+ (generate_makefile): Adjust.
+ * lib/am/check.am [%?PARALLEL_TESTS%] (check-TESTS): Pass
+ sanitized TEST_LOGS value as makefile snippet on standard
+ input to $(MAKE), to avoid exceeding the command line limit on
+ w32 (MSYS).
+ * NEWS: Update.
+ Report by Bob Friesenhahn.
+
+ Posix 2008 requires make to set errexit.
+ * lib/am/check.am: Update comment.
+
+ 2010-08-27 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix bug in test missing6.test.
+ * tests/missing6.test: Fix the hack used to edit `configure.in',
+ to avoid producing a configure script that breaks with shells
+ that do not support $LINENO. Also throw in a couple of cosmetic
+ changes.
+
+ 2010-08-21 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Improve robustness of mdate-sh script.
+ * lib/mdate-sh: Sanitize zsh behavior on startup, to ensure
+ $ls_command is word-split properly upon invocation.
+ (error): New function.
+ (main): Use it. Improve error checking to avoid endless loop
+ in case $ls_command gave bogus output. Fix eval quotation.
+ * tests/mdate6.test: New test, to expose eval quotation error.
+ * tests/Makefile.am: Update.
+
+ 2010-08-18 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Fix potential regressions in depcomp{3,5}.test.
+ * tests/depcomp3.test: Do not uselessly escape the character `$'
+ in makefile rules, when it's used to expand a make macro.
+ * tests/depcomp5.test: Likewise.
+
+ 2010-08-17 Stefano Lattarini <stefano.lattarini@gmail.com>
+ Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Docs: clarify how to avoid automatic dependencies tracking.
+ * doc/automake.texi (Automatic dependency tracking): Mention that
+ automatic dependencies tracking is enabled by default, but that
+ the package developer can disable it altogether. Add a reference
+ to the proper section for a more in-depth explanation.
+
+ Fix typo in manual (`Makefile.in' instead of `Makefile.am').
+ * doc/automake.texi (Automatic dependency tracking): Fix typo.
+
+ 2010-08-16 Bruno Haible <bruno@clisp.org>
+
+ Don't hide the table of contents.
+ * doc/automake.texi: Move the table of contents to the beginning.
+
+ 2010-08-10 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Tweak and/or extend some `acloca*.test' tests.
+ * tests/aclocal8.test: Ensure verbose printing of captured
+ output.
+ * tests/aclocal.test: Likewise. Also, add trailing `:'
+ command.
+ * tests/acloca19.test: Likewise.
+ * tests/aclocal5.test: Add trailing `:' command, and prefer
+ `$me' over hard-coded test name.
+ * tests/aclocal6.test: Likewise.
+ * tests/aclocal18.test: Add trailing `:' command, and make
+ some grepping slightly stricter.
+ * tests/acloca14.test: Likewise. Also, prefer `diff' over
+ `cmp', and add some "cosmetic" blank lines.
+
+ 2010-08-09 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Tweak and extend tests `pr[!0-9]*.test'.
+ * tests/primary3.test: Add trailing `:' command.
+ * tests/primary.test: Make grepping of Automake's stderr stricter.
+ Also, add trailing `:' command, and cosmetic changes in spacing.
+ * tests/primary2.test: Likewise.
+ * tests/prefix.test: Enable `errexit' shell flags, and related
+ changes. Add a trailing `:' command.
+ * tests/proginst.test: Likewise.
+
+ Modernize, improve and extend tests for PR (`pr[0-9]*.test').
+ * tests/pr2.test: Add trailing `:' command.
+ * tests/pr229.test: Likewise.
+ * tests/pr401.test: Likewise.
+ * tests/pr401b.test: Likewise.
+ * tests/pr401c.test: Likewise.
+ * tests/pr300-prog.test: Likewise, plus cosmetic changes in
+ spacing.
+ * tests/pr300-lib.test: Likewise.
+ * tests/pr300-ltlib.test: Likewise, and ensure verbose printing
+ of captured make stdout.
+ * tests/pr211.test: Add trailing `:' command. Also, use the
+ `configure.in' stub created by ./defs, rather than writing it
+ from scratch.
+ * tests/pr204.test: Likewise, plus cosmetic spacing changes.
+ * tests/pr287.test: Likewise, and move setting of `errexit' shell
+ flag earlier in the script (just after inclusion of ./defs).
+ * tests/pr220.test: Make grepping of Automake's stderr stricter.
+ Also, add trailing `:' command, and cosmetic changes in spacing.
+ * tests/pr224.test: Move setting of `errexit' shell flag earlier
+ in the script (just after inclusion of ./defs). Do not export
+ `CC=gcc' to configure explicitly (it's already exported globally
+ in ./defs, since we have "gcc" in $required). Use the stub for
+ `configure.in' created by ./defs, rather than writing it from
+ scratch. Do not create dummy files required by "gnu" mode (e.g.
+ README, NEWS), since we run automake in foreign mode anyway.
+ * tests/pr72.test: Enable `errexit' shell flags, and related
+ changes. Extend existing checks a bit.
+ * tests/pr9.test: Likewise. Also, avoid obsolescent constructs in
+ the generated `configure.in', and extend existing checks over the
+ generated tarball a bit.
+ * tests/pr87.test: Enable `errexit' shell flags, and related
+ changes. Add a trailing `:' command. Also, do not create dummy
+ files required by "gnu" mode (e.g. README, NEWS), since we run
+ automake in foreign mode anyway.
+ * tests/pr243.test: Avoid obsolescent constructs in the generated
+ `configure.in'. Enable the `errexit' shell flag, and related
+ changes. Cosmetic changes to spacing, add trailing `:' command,
+ and add a "FIXME" comment.
+ * tests/pr266.test: Likewise, and add explicit command line switch
+ `--enable-dependecy-tracking' to the ./configure call.
+ * tests/pr279.test: Avoid obsolescent constructs in the generated
+ `configure.in'; also, use the `configure.in' stub created by
+ ./defs, rather than writing it from scratch. Enable `errexit'
+ shell flag, and related changes. Add trailing `:' command.
+ * tests/pr279-2.test: Likewise, and make grepping of Makefile.in
+ stricter.
+ * tests/pr307.test: Move setting of `errexit' shell flag earlier
+ in the script (just after inclusion of ./defs). Escape literal
+ dots in grep regular expressions. Also, add a trailing `:'
+ command, and cosmetic changes to spacing.
+
+ Tests for PR: add excerpts from original bug report, for clarity.
+ * tests/pr2.test: Ditto.
+ * tests/pr9.test: Likewise.
+ * tests/pr72.test: Likewise.
+ * tests/pr87.test: Likewise.
+ * tests/pr211.test: Likewise.
+ * tests/pr220.test: Likewise.
+ * tests/pr224.test: Likewise.
+ * tests/pr229.test: Likewise.
+ * tests/pr243.test: Likewise.
+ * tests/pr266.test: Likewise.
+ * tests/pr279.test: Likewise, and tell to keep it in sync
+ with its sister test.
+ * tests/pr279-2.test: Likewise.
+
+ 2010-08-08 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Tweak, extend and improve tests `cond[a-z]*.test'.
+ * tests/condd.test: Add trailing `:' command. Typofix in
+ comment.
+ * tests/condhook.test: Make sure target `install-data-hook' is
+ not called by `make install', but that data files are installed.
+ Use proper m4 quoting in configure.in. Add trailing `:' command.
+ * tests/condhook2.test: New test, sister test of condhook, with
+ inverted semantic.
+ * tests/condinc2.test: Use proper m4 quoting in configure.in.
+ Prefer trailing `:' command over trailing `Exit 0'.
+ * tests/condman2.test: Enable errexit shell flag, and related
+ changes. Add trailing `:' command.
+ * tests/condman.test: Likewise. Also, do not create useless
+ dummy manpages, and use proper m4 quoting in configure.in.
+ * tests/condman3.test: New test, similar to condman.test, but
+ it also runs ./configure and "make install", and check the
+ installed files.
+ * tests/Makefile.am (TESTS): Updated.
+
+ Modernize, improve and/or extend tests `colon*.test.
+ * tests/colon.test: Rely on the `configure.in' stub created by
+ `./defs', rather than writing one from scratch. Do not create
+ a useless dummy file. Add trailing `:' command.
+ * tests/colon4.test: Enable the `errexit' shell flag, and
+ related changes. Rely on the `configure.in' stub created by
+ `./defs', rather than writing one from scratch.
+ * tests/colon7.test: Enable `errexit' shell flag, and related
+ changes. Improve the generated `configure.in' file. Add
+ trailing `:' command.
+ * tests/colon2.test: Likewise. Also, add some new checks.
+ * tests/colon5.test: Improve the generated `configure.in' file.
+ Add new, much deeper checks. Add trailing `:' command.
+ * tests/colon6.test: Likewise.
+ * tests/colon3.test: Add trailing `:' command. Remove useless
+ comments and echos. Improve the generated `configure.in' file.
+ make some grepping tests stricter. Add a "FIXME" comments about
+ planned improvements.
+
+ Improve and extend tests `asm*.test'.
+ * tests/asm.test: Use configure.in stub generated by ./defs,
+ and avoid obsoleted autoconf constructs. Make grepping of
+ Automake stderr stricter. Do not create useless source file.
+ Improve verbose messages. Minor cosmetic changes. Tell to
+ keep it in sync with other sister tests asm*.test.
+ * tests/asm2.test: Likewise.
+ * tests/asm3.test: Likewise.
+
+ Modernize, improve and/or extend test scripts `conf*.test'.
+ * tests/confh5.test: Cosmetic changes.
+ * tests/conff.test: Likewise.
+ * tests/confdeps.test: Likewise.
+ * tests/conflnk.test: Likewise.
+ * tests/conflnk2.test: Likewise.
+ * tests/confsub.test: Likewise.
+ * tests/confvar.test: Likewise, and make grepping of Makefile.in
+ stricter.
+ * tests/confvar2.test: Likewise.
+ * tests/conflnk3.test: Cosmetic changes. Re-enable a temporarily
+ disabled test (which didn't work with autoconf <= 2.59, but now we
+ are requiring autoconf 2.62, so...)
+ * tests/conflnk4.test: Cosmetic changes, and extend existing tests
+ accordingly to "TODO" comments.
+ * tests/conff2.test: Make grepping of Automake's stderr stricter.
+ Add some comments explaining why we don't use the `configure.in'
+ stub preset be ./defs.
+ * tests/confh.test: Use the `configure.in' stub created by ./defs,
+ rather than writing one from scratch, and do not call AC_OUTPUT.
+ Enable `errexit' shell flag, and related changes. Prefer diff over
+ cmp to compare text files. Prefer perl over sed to fetch the value
+ of $(DIST_COMMON) from Makefile.in. Make grepping of the contents
+ of $(DIST_COMMON) stricter.
+ * tests/confh4.test: Use the `configure.in' stub created by ./defs,
+ rather than writing one from scratch. Make grepping of Makefile.in
+ stricter.
+ * tests/confh5.test: Make grepping of `config.h' stricter. Add a
+ comment.
+ * tests/configure.test: Avoid obsolescent constructs in generated
+ `configure.ac'. Do not write `configure.in' two times. Escape
+ literal dots in grep regular expressions.
+ * tests/confincl.test: Enable `errexit' shell flag, and related
+ changes. Prefer fgrep over grep. Other cosmetic changes.
+ * tests/config.test: Renamed to ...
+ * tests/confh6.test: ... this. Fix m4 quoting in `configure.in',
+ and make grepping of `config.h' and `config.h.in' stricter.
+ * tests/conf2.test: Renamed ...
+ * tests/confh7.test: ... to this. Use the `configure.in' stub
+ created by ./defs, rather than writing one from scratch. Try to
+ run the checks both with and without AC_PROG_CC and AC_OUTPUT in
+ `configure.in'.
+ * tests/Makefile.am (TESTS): Updated.
+
+ Minor improvements and fixes in tests `depcomp*.test'.
+ * tests/depcomp.test: Do not create useless dummy source files.
+ Add a trailing `:' command.
+ * tests/depcomp2.test: Use `unset' on the CFLAG variable to ensure
+ it's not in in the environment, rather than exporting it with an
+ empty value. Do not pass CC=gcc to configure, as that's already
+ done in ./defs since we have gcc in $required. Ensure verbose
+ printing of captured stderr, and normalize its checking. Add a
+ trailing `:' command.
+ * tests/depcomp3.test: Quote literal dots and dollar characters in
+ grep regexps. Always use `: >' rather than `touch' to create empty
+ files. Explicitly declare phony targets as such in the created
+ Makefile.am. Add a trailing `:' command.
+ * tests/depcomp4.test: Quote literal dots and dollar characters in
+ grep regexp. Explicitly declare phony targets as such in the
+ created Makefile.am. Ensure verbose printing of captured makes'
+ stoud/stderr. Add a trailing `:' command.
+ * tests/depcomp5.test: Move setting of `errexit' shell flag earlier
+ in the script (just after inclusion of ./defs). Quote literal dots
+ and dollar characters in grep regexps. Explicitly declare phony
+ targets as such in the created Makefile.am. Add a trailing `:'
+ command.
+ * tests/depcomp6.test: Consistently use m4 quoting in the generated
+ configure.in. Cosmetic fixes to spacing. Make the "dummy" `if'
+ statement required by OpenBSD's sh `set -e' more robust, and add
+ explanatory comments to it.
+ * tests/depcomp7.test: Likewise, and add a trailing `:' command.
+
+ Separate failing part of test `all.test'.
+ * tests/all.test: Keep only (x)failing part of the test. Working
+ checks moved out to ...
+ * tests/all2.test: ... this new test.
+ * tests/Makefile.am (TESTS): Updated.
+
+ Modernize, improve and extend tests `subobj*.test'.
+ * tests/subobjname.test: Add trailing `:' command.
+ * tests/subobj.test: Make grepping of `Makefile.in' stricter.
+ Escape literal dots in grep regexps.
+ * tests/subobj2.test: Add trailing `:' command. Do not use the
+ unportable fgrep option `-e'.
+ * tests/subobj3.test: Add trailing `:' command.
+ (configure.in): Use proper m4 quoting, and avoid obsolescent
+ constructs.
+ * tests/subobj8.test: Likewise. Also, enable `errexit' shell
+ flag, with related changes
+ * tests/subobj4.test: Likewise. Also, make grepping of
+ `Makefile.in' stricter.
+ * tests/subobj5.test: Add trailing `:' command. Move setting of
+ `errexit' shell flag earlier in the script (just after inclusion
+ of ./defs).
+ (configure.in): Use the stub created by `./defs', rather than
+ writing it from scratch, and avoid obsolescent constructs.
+ * tests/subobj6.test: Add trailing `:' command. Move setting of
+ `errexit' shell flag earlier in the script (just after inclusion
+ of ./defs). Do not create useless dummy ac-init file `f'.
+ * tests/subobj7.test: Do not create useless dummy ac-init file
+ `f'.
+ (configure.in): Use the stub created by `./defs', rather than
+ writing it from scratch, and avoid obsolescent constructs.
+ * tests/subobj9.test: Move setting of `errexit' shell flag earlier
+ in the script (just after inclusion of ./defs). Fail the test if
+ `make distcheck' fails. Ensure verbose printing of captured make
+ stdout. Avoid useless fork by doing simple grep instead of using
+ test -n "`COMMAND | grep ...`".
+ (configure.in): Normalize the call to AC_INIT w.r.t. other tests.
+ (Makefile.am): Explicitly mark target "print" as phony.
+ * tests/subobj10.test: Removed duplicated call to `set -e'. Add
+ trailing `:' command.
+ (configure.in): Normalize the call to AC_INIT w.r.t. other tests.
+
+ Remove a couple of obsoleted tests.
+ * tests/fpinstall.test: Removed.
+ * tests/fpinst2.test: Likewise.
+ * tests/Makefile.am (TESTS): Updated.
+
+ Bootstrap: updated HACKING entry.
+ * HACKING ("Working with git"): Explain how to override the
+ autoconf and autom4te programs used by the bootstrap process.
+
+ Bootstrap: fixlet.
+ * bootstrap: Do not remove `lib/Automake/Config.pm' anymore,
+ since we don't generate it. Correctly quote arguments of
+ `eval' builtin. Fixed a botched error message. Removed an
+ extra blank line.
+
+ Bootstrap: don't search perl in $PATH.
+ * bootstrap: Do not explicitly search perl in $PATH anymore.
+ ($PATH_SEPARATOR): Removed, it's no more needed.
+
+ Bootstrap: let the user choose which autoconf to use.
+ * bootstrap ($AUTOCONF): New variable, from the environment.
+ ($AUTOM4TE): Likewise, for clarity.
+ Use "$AUTOCONF" instead of calling "autoconf" directly.
+
+ Minor improvements to tests ar*.test.
+ * tests/ar.test: Add trailing `:' command.
+ * tests/ar2.test: Likewise, and make grepping of generated
+ Makefile.in stricter.
+
+ 2010-08-08 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Fix maintainer-check failure.
+ * tests/cond5.test: Quote sleep argument, this isn't about
+ time stamp differences.
+
+ Sync auxiliary files from upstream.
+ * lib/config.guess, lib/config.sub, lib/texinfo.tex:
+ Sync from upstream.
+
+ 2010-08-06 Stefano Lattarini <stefano.lattarini@gmail.com>
+
+ Work around a nasty bug (segfault) of Solaris make.
+ * lib/am/check.am (recheck, recheck-html): Trim trailing spaces
+ from $list, to avoid triggering a nasty bug (potential segfault)
+ on Solaris make.
+
+ 2010-08-06 Peter Rosin <peda@lysator.liu.se>
+
+ Make cond5.test more robust on MSYS.
+ * tests/cond5.test: Add delay before the first kill attempt to
+ cater for problems with MSYS bash.
+
+2010-11-16 Peter Rosin <peda@lysator.liu.se>
+
+ Skip MSVC oriented tests if the shell is not capable.
+ * tests/defs: New required entry 'xsi-shell'.
+ * tests/ar-lib.test, tests/compile3.test, tests/compile6.test:
+ Require a XSI capable shell.
+ Reported by Ralf Wildenhues.
+
+2010-11-15 Peter Rosin <peda@lysator.liu.se>
+
+ compile: clear the `eat' variable earlier.
+ * lib/compile: Clear the `eat' variable earlier.
+ ($scriptversion): Update.
+ * tests/compile3.test: Prevent regressions.
+
+2010-10-07 Peter Rosin <peda@lysator.liu.se>
+
+ depcomp: add new one-pass depmode for MSVC 7 and later.
+ * lib/depcomp: Add new depmodes 'msvc7' and 'msvc7msys' which
+ make use of the -showIncludes option added in MSVC 7.
+ * m4/depend.m4 (_AM_DEPENDENCIES): Handle the new depmodes
+ similarly to 'msvisualcpp' and 'msvcmsys' as MSVC does not
+ support the -o option.
+
+2010-10-03 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ tests: fix ar-lib.test for echo that interprets backslashes.
+ * tests/ar-lib.test: Use printf instead of echo. Avoid test -a.
+ More robust quoting.
+
+2010-09-21 Peter Rosin <peda@lysator.liu.se>
+
+ compile: implement library search to support MSVC static linking
+ * lib/compile (func_cl_wrapper): Implement library search and
+ -static option so that the user can select whether to prefer
+ dll import libraries or static libraries. This enables MSVC to
+ link against dlls generated by libtool without requiring libtool
+ or workarounds such as -lfoo.dll etc. Makes the tests/static.at
+ test case in libtool pass.
+ * tests/compile3.test: Don't trip up if there happens to exist
+ a "foo" library in the library search path.
+ * tests/compile6.test: New test, verifying the library search.
+ * tests/Makefile.am (TESTS): Update.
+
+2010-09-02 Peter Rosin <peda@lysator.liu.se>
+
+ Make ar-lib support backslashed files in archives.
+ * lib/ar-lib: If an archive member contains a backslash, make sure
+ it is escaped when the archive member is extracted.
+ * tests/ar-lib.test: Test the above.
+
+2010-08-31 Peter Rosin <peda@lysator.liu.se>
+
+ Do file name conversion for object files in the compile wrapper.
+ * lib/compile (func_cl_wrapper): Do file name conversion for object
+ files (i.e. extensions .obj, .OBJ, .o and .O) if needed.
+ * tests/compile4.test: Test the above.
+
+2010-08-16 Peter Rosin <peda@lysator.liu.se>
+
+ Optimize compile script on MSYS.
+ * lib/compile (func_file_conv): Add new argument 'lazy' which
+ takes an optional list of conversion types where the requested
+ conversion isn't needed.
+ (func_cl_wrapper): Take advantage of the above for cases where
+ MSYS is doing the conversion for us.
+ Suggested by Ralf Wildenhues.
+
+2010-08-16 Peter Rosin <peda@lysator.liu.se>
+
+ Support more C++ file extensions for MSVC in the compile script.
+ * lib/compile (func_cl_wrapper): MSVC only recognizes the .cpp
+ file extension as C++, unless it's given a hint. So hint about
+ .cc, .CC, .cxx, .CXX, c++ and C++. Also do path conversion on
+ .c, .cpp, .CPP, .lib, .LIB and .Lib files.
+ * tests/compile3.test: Test the C++ hinting.
+
+2010-08-12 Peter Rosin <peda@lysator.liu.se>
+
+ Enable the use of "link -lib" as the wrapped archiver.
+ * lib/ar-lib: Enable the use of "link -lib" as the wrapped
+ archiver, as well as allowing some other options to be passed
+ through to the wrapped archiver.
+ * tests/ar-lib.test: Test the above.
+
+2010-08-06 Peter Rosin <peda@lysator.liu.se>
+
+ Add new auxiliary 'ar-lib' script, wrapping Microsoft lib.
+ * lib/ar-lib: New auxiliary script.
+ * lib/Makefile.am: Add above.
+ * tests/ar-lib.test: New test.
+ * tests/Makefile.am: Add above.
+ * automake.in (@common_files): Distribute the 'ar-lib' script.
+ * doc/automake.texi (Auxiliary Programs): Mention the new
+ 'ar-lib' script.
+ (Optional): Mention 'ar-lib' in AC_CONFIG_AUX_DIR.
+ * NEWS: Update.
+
+2010-08-07 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+
+ Fix shell pattern negation in compile script.
+ * lib/compile (func_file_conv): Use `!' not `^' for pattern
+ negation.
+
+2010-08-01 Peter Rosin <peda@lysator.liu.se>
+
+ Wrap some MSVC options in the compile script.
+ * lib/compile: MSVC supports naming the output file, the option
+ is just not called -o, so transform -o into the appropriate form
+ for MSVC. Also wrap some other options while at it (-L, -l, -Wl,
+ -Xlinker and -I) and convert file names to windows form where
+ needed for those options to make MSVC more usable in an
+ autotooled environment.
+ * doc/automake.texi (Auxiliary Programs): Document the above
+ extension of the compile script.
+ * NEWS: Updated.
+ * tests/defs.in: New required entry 'cl'.
+ * tests/compile3.test: New test.
+ * tests/compile4.test: New test.
+ * tests/compile5.test: New test.
+ * tests/Makefile.am: Update.
+
2010-07-31 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
Add example git work flow; discuss merge --log in HACKING.
the background automake process, but poll it every 10 seconds for
at most 30 times (this makes the test both faster on good machines,
and more resilient to spurious timeout-due failures when in low
- priority or on havily-loaded systems).
+ priority or on heavily-loaded systems).
Check also that automake writes the expected error messages on the
standard error.
Enable `errexit' flag, and related changes.
source file.
* tests/suffix7.test: Likewise.
* tests/suffix5.test: Enable `errexit' shell flag, and related
- changes. Make grepping of Makefile.in slighty stricter.
+ changes. Make grepping of Makefile.in slightly stricter.
* tests/suffix.test: Enable `errexit' shell flag, and related
changes. Also, do not redirect grep output to /dev/null, as this
might unmotivatedly hide useful information.
$FGREP rather than plain grep.
* tests/suffix11.test: Likewise.
* tests/suffix12.test: Likewise.
- * tests/suffix9.test: Prefet cat + here-doc over echo to append to
+ * tests/suffix9.test: Prefer cat + here-doc over echo to append to
the `configure.in' stub. Cosmetic changes.
* tests/suffix13.test: Cosmetic spacing change.
useless `if' statement is indeed required.
Add useful comment in test script obsolete.test.
- * tests/obsolte.test: Add a comment explaining why we need
+ * tests/obsolete.test: Add a comment explaining why we need
an indirection in adding $AUTOUPDATE to $required.
Normalize whitespaces in 'tests/Makefile.am'.
changes, and a couple of unrelated cosmetic changes.
* tests/recurs.test: Use the `configure.in' stub created by
`./defs', rather than writing one from scratch. Make grepping
- of Automake stderr slighty stricter.
+ of Automake stderr slightly stricter.
* tests/substtarg.test: Likewise.
* tests/strip.test: Likewise, and move the call to `set -e'
earlier (just after the inclusion of `./defs'). Also, make sure
in ./defs). Avoid potential problems with unpredictable make
output. Finally, make grepping of Makefile.in stricter.
* tests/substre2.test: Ensure verbose printing of the captured
- make's output, and make its grepping slighty stricter.
+ make's output, and make its grepping slightly stricter.
* tests/cygwin32.test: Enable `errexit' shell flag, and related
changes. Also, do not create useless dummy source/data files.
* tests/scripts.test: Likewise.
here-doc, not using echo.
* tests/pluseq10.test: Make sure that the captured output of
`make' command is always displayed. Where possible, use $FGREP
- instead of grep (this change makes some checks slighty stricter).
+ instead of grep (this change makes some checks slightly stricter).
* tests/pluseq8.test: Enable `errexit' shell flag, with related
changes.
* tests/pluseq.test: Likewise. Also, do not create useless dummy
* tests/pluseq4.test: Likewise.
* tests/pluseq6.test: Likewise.
* tests/pluseq7.test: Do not create useless dummy source file.
- * tests/pluseq9.test: Slighty extended w.r.t. the grepping of
+ * tests/pluseq9.test: Slightly extended w.r.t. the grepping of
Automake stderr. Some unrelated cosmetic changes.
Testsuite: ensure verbose printing of captured stderr.
2010-06-11 Stefano Lattarini <stefano.lattarini@gmail.com>
Improve determination of PATH separator in bootstrap script.
- * bootstrap: Detemine what the PATH separator is the same way
+ * bootstrap: Determine what the PATH separator is the same way
autoconf does.
Minor improvements in bootstrap script.
$AUTOMAKE, and improve the positioning of an $ACLOCAL call.
* tests/exeext4.test: Use $FGREP instead of grep, where possible.
Make auxiliary rules in the generated Makefile more silent.
- These changes make some checks slighty stricter.
+ These changes make some checks slightly stricter.
* tests/ext2.test: Call `Exit 1' if inclusion of `./defs' fails.
* tests/gettext2.test: Place final `:' at the end of the script,
rather than in the middle.
* tests/python2.test: Improved verbose messages.
Make test `ammissing.test' stricter.
- * tests/ammissing.test: Fail if $ACLOCAL succeds unexpectedly.
+ * tests/ammissing.test: Fail if $ACLOCAL succeeds unexpectedly.
Enable `errexit' shell flag.
2010-06-08 Stefano Lattarini <stefano.lattarini@gmail.com>
* tests/nodep.test: Likewise.
* tests/nodepcomp.test: Likewise.
* tests/f90only.test: Likewise, and remove botched/obsoleted
- comments and unecessary commands.
+ comments and unnecessary commands.
* tests/fonly.test: Likewise, and remove botched/obsoleted
- comments and unecessary commands.
+ comments and unnecessary commands.
* tests/discover.test: Likewise, and made stricter.
Enable `errexit' shell flag in all tests cxx*.test.
Extend test on `nostdinc' automake option.
* tests/nostdinc.test: Enable `errexit' shell flag. Related and
unrelated minor changes. Make the grepping of the generated
- Makefile.in slighty stricter. Generate and run configure, so that
+ Makefile.in slightly stricter. Generate and run configure, so that
the generated Makefile can be grepped too.
2010-05-23 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
-----
- Copyright (C) 2010 Free Software Foundation, Inc.
+ Copyright (C) 2010, 2011 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification, are
permitted provided the copyright notice and this notice are preserved.
New in 1.11.0a:
+ * WARNING: Future backward-incompatibilities!
+
+ - The Automake support for automatic de-ANSI-fication will be removed in
+ the next major Automake release (1.12).
+
* Miscellaneous changes:
- The `lzma' compression scheme and associated automake option `dist-lzma'
is obsoleted by `xz' and `dist-xz' due to upstream changes.
+ - The `compile' script now converts some options for MSVC for a better
+ user experience. Similarly, the new `ar-lib' script wraps Microsoft lib.
+
+ - A developer that needs to pass specific flags to configure at "make
+ distcheck" time can now, and indeed he's advised to, do so by defining
+ the developer-reserved makefile variable AM_DISTCHECK_CONFIGURE_FLAGS,
+ instead of the old DISTCHECK_CONFIGURE_FLAGS.
+ The DISTCHECK_CONFIGURE_FLAGS variable should now be reserved for the
+ user; still, the old Makefile.am files that used to define it should
+ still continue to work as before.
+
Bugs fixed in 1.11.0a:
* Bugs introduced by 1.11:
- The `parallel-tests' test driver works around a GNU make 3.80 bug with
- trailing white space in the test list (`TESTS = foo $(EMPTY)').
+ trailing white space in the test list (`TESTS = foo $(EMPTY)'), and
+ does not report spurious successes when used with concurrent FreeBSD
+ make (e.g., "make check -j3").
- The `silent-rules' option now also silences all compile rules if dependency
tracking is disabled. Also, when `silent-rules' is not used, the output from
* Long standing bugs:
+ - Automake now warns about more primary/directory invalid combinations,
+ such as "doc_LIBRARIES" or "pkglib_PROGRAMS".
+
- On Darwin 9, `pythondir' and `pyexecdir' pointed below `/Library/Python'
even if the `--prefix' argument pointed outside of a system directory.
AM_PATH_PYTHON has been fixed to ignore the value returned from python's
- The order of Yacc and Lex flags is fixed to be consistent with other
languages: $(AM_YFLAGS) comes before $(YFLAGS), and $(AM_LFLAGS) before
$(LFLAGS), so that the user variables override the developer variables.
+
+ - Rules generated by Automake now try harder to not change any files when
+ `make -n' is invoked. Fixes include compilation of Emacs Lisp, Vala, or
+ Yacc source files and the rule to update config.h.
+
+ - The code for automatic dependency tracking works around a Solaris
+ make bug triggered by sources containing repeated slashes when the
+ `subdir-objects' option was used.
+
+ - The parallel-tests driver now does not produce erroneous results
+ with Tru64/OSF 5.1 sh upon unreadable log files any more.
+
+ - The makedepend and hp depmodes now works better with VPATH builds.
+
+ - Java sources specified with check_JAVA are not compiled anymore upon
+ "make all", but only upon "make check".
+
+ - Now aclocal and automake, when they've to spawn autoconf or autom4te
+ processes, honour the configure-time definitions of AUTOCONF and
+ AUTOM4TE.
\f
New in 1.11:
\f
New in 0.31:
* Bug fixes
- * Documentation updates (many from François Pinard)
+ * Documentation updates (many from François Pinard)
* strictness `normal' now renamed to `foreign'
* Renamed --install-missing to --add-missing
* Now handles AC_CONFIG_AUX_DIR
* Comments in Makefile.am are placed more intelligently in Makefile.in
* Generates .PHONY target
* Rule or macro in Makefile.am now overrides contents of Automake file
- * Substantial cleanups from François Pinard
+ * Substantial cleanups from François Pinard
\f
New in 0.25:
* Bug fixes.
-----
Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
- 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
+ 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
+ Foundation, Inc.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
# automake - create Makefile.in from Makefile.am
# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
- # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software
+ # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
# Foundation, Inc.
# This program is free software; you can redistribute it and/or modify
my @common_files =
(qw(ABOUT-GNU ABOUT-NLS AUTHORS BACKLOG COPYING COPYING.DOC COPYING.LIB
COPYING.LESSER ChangeLog INSTALL NEWS README THANKS TODO
- ansi2knr.1 ansi2knr.c compile config.guess config.rpath config.sub
- depcomp elisp-comp install-sh libversion.in mdate-sh missing
- mkinstalldirs py-compile texinfo.tex ylwrap),
+ ansi2knr.1 ansi2knr.c ar-lib compile config.guess config.rpath
+ config.sub depcomp elisp-comp install-sh libversion.in mdate-sh
+ missing mkinstalldirs py-compile texinfo.tex ylwrap),
@libtool_files, @libtool_sometimes);
# Commonly used files we auto-include, but only sometimes. This list
# Standard directories from the GNU Coding Standards, and additional
# pkg* directories from Automake. Stored in a hash for fast member check.
my %standard_prefix =
- map { $_ => 1 } (qw(bin data dataroot dvi exec html include info
- lib libexec lisp localstate man man1 man2 man3
- man4 man5 man6 man7 man8 man9 oldinclude pdf
- pkgdatadir pkgincludedir pkglibdir pkglibexecdir
- ps sbin sharedstate sysconf));
+ map { $_ => 1 } (qw(bin data dataroot doc dvi exec html include info
+ lib libexec lisp locale localstate man man1 man2
+ man3 man4 man5 man6 man7 man8 man9 oldinclude pdf
+ pkgdata pkginclude pkglib pkglibexec ps sbin
+ sharedstate sysconf));
# Copyright on generated Makefile.ins.
my $gen_copyright = "\
# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
- # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software
+ # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
# Foundation, Inc.
# This Makefile.in is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
my %done;
- # Is the c linker needed?
+ # Is the C linker needed?
my $needs_c = 0;
foreach my $ext (sort keys %extension_seen)
{
# Each item on this list is a reference to a list consisting
# of four values followed by additional transform flags for
- # file_contents. The four values are the derived flag prefix
+ # file_contents. The four values are the derived flag prefix
# (e.g. for `foo_CFLAGS', it is `foo'), the name of the
# source file, the base name of the output file, and
# the extension for the object file.
# derived from is not.
&push_dist_common ($object)
unless ($topparent =~ /^(?:nobase_)?nodist_/);
+
+ # If resulting derived source is in a subdir, we need to make
+ # sure the subdir exists at build time.
+ if ($object =~ /\//)
+ {
+ my $dirstamp = require_build_directory_maybe ($object);
+ depend ($object, $dirstamp)
+ if ($dirstamp);
+ }
next;
}
# Transform .o or $o file into .P file (for automatic
# dependency code).
- if ($lang && $lang->autodep ne 'no')
- {
- my $depfile = $object;
- $depfile =~ s/\.([^.]*)$/.P$1/;
- $depfile =~ s/\$\(OBJEXT\)$/o/;
- $dep_files{dirname ($depfile) . '/$(DEPDIR)/'
- . basename ($depfile)} = 1;
- }
+ # Properly flatten multiple adjacent slashes, as Solaris 10 make
+ # might fail over them in an include statement.
+ # Leading double slashes may be special, as per Posix, so deal
+ # with them carefully.
+ if ($lang && $lang->autodep ne 'no')
+ {
+ my $depfile = $object;
+ $depfile =~ s/\.([^.]*)$/.P$1/;
+ $depfile =~ s/\$\(OBJEXT\)$/o/;
+ my $maybe_extra_leading_slash = '';
+ $maybe_extra_leading_slash = '/' if $depfile =~ m,^//[^/],;
+ $depfile =~ s,/+,/,g;
+ my $basename = basename ($depfile);
+ # This might make $dirname empty, but we account for that below.
+ (my $dirname = dirname ($depfile)) =~ s/\/*$//;
+ $dirname = $maybe_extra_leading_slash . $dirname;
+ $dep_files{$dirname . '/$(DEPDIR)/' . $basename} = 1;
+ }
}
return @result;
if ($val !~ /^-[lL]/ &&
# Skip -dlopen and -dlpreopen; these are explicitly allowed
# for Libtool libraries or programs. (Actually we are a bit
- # laxe here since this code also applies to non-libtool
+ # lax here since this code also applies to non-libtool
# libraries or programs, for which -dlopen and -dlopreopen
# are pure nonsense. Diagnosing this doesn't seem very
# important: the developer will quickly get complaints from
require_file ($ansi2knr_where, FOREIGN,
'ansi2knr.c', 'ansi2knr.1');
- # ansi2knr needs to be built before subdirs, so unshift it.
+ # ansi2knr needs to be built before subdirs, so unshift it
+ # rather then pushing it.
unshift (@all, '$(ANSI2KNR)');
}
else
sub handle_programs
{
my @proglist = &am_install_var ('progs', 'PROGRAMS',
- 'bin', 'sbin', 'libexec', 'pkglib',
+ 'bin', 'sbin', 'libexec', 'pkglibexec',
'noinst', 'check');
return if ! @proglist;
# ------------------------------------------------------------------
# SOURCE - the source Texinfo file
# DEST - the destination Info file
- # INSRC - wether DEST should be built in the source tree
+ # INSRC - whether DEST should be built in the source tree
# DEPENDENCIES - known dependencies
sub output_texinfo_build_rules ($$$@)
{
sub handle_data
{
&am_install_var ('-noextra', '-candist', 'data', 'DATA',
- 'data', 'dataroot', 'dvi', 'html', 'pdf', 'ps',
- 'sysconf', 'sharedstate', 'localstate',
+ 'data', 'dataroot', 'doc', 'dvi', 'html', 'pdf',
+ 'ps', 'sysconf', 'sharedstate', 'localstate',
'pkgdata', 'lisp', 'noinst', 'check');
}
# Compute a list of dependencies appropriate for the rebuild
# rule of
# AC_CONFIG_FILES($OUTPUT:$INPUT[0]:$INPUTS[1]:...)
- # Also distribute $INPUTs which are not built by another AC_CONFIG_FOOS.
+ # Also distribute $INPUTs which are not built by another AC_CONFIG_FOOs.
sub rewrite_inputs_into_dependencies ($@)
{
my ($file, @inputs) = @_;
$dir = $curs;
}
-
- push (@all, 'class' . $dir . '.stamp');
+ if ($dir eq 'check')
+ {
+ push (@check, "class$dir.stamp");
+ }
+ else
+ {
+ push (@all, "class$dir.stamp");
+ }
}
sinclude => 1,
);
- my $traces = ($ENV{AUTOCONF} || 'autoconf') . " ";
+ my $traces = ($ENV{AUTOCONF} || '@am_AUTOCONF@') . " ";
# Use a separator unlikely to be used, not `:', the default, which
# has a precise meaning for AC_CONFIG_FILES and so on.
{
foreach my $file ($var->value_as_list_recursive)
{
- $output_rules .= "\$(srcdir)/$file: \$(srcdir)/${derived}_vala.stamp\n".
- "\t\@if test -f \$@; then :; else \\\n".
- "\t rm -f \$(srcdir)/${derived}_vala.stamp; \\\n".
- "\t \$(am__cd) \$(srcdir) && \$(MAKE) \$(AM_MAKEFLAGS) ${derived}_vala.stamp; \\\n".
- "\tfi\n"
+ $output_rules .= "\$(srcdir)/$file: \$(srcdir)/${derived}_vala.stamp\n"
+ . "\t\@if test -f \$@; then :; else rm -f \$(srcdir)/${derived}_vala.stamp; fi\n"
+ . "\t\@if test -f \$@; then :; else \\\n"
+ . "\t \$(am__cd) \$(srcdir) && \$(MAKE) \$(AM_MAKEFLAGS) ${derived}_vala.stamp; \\\n"
+ . "\tfi\n"
if $file =~ s/(.*)\.vala$/$1.c/;
}
}
'--vapi', '--internal-vapi', '--gir')))
{
my $headerfile = $flag;
- $output_rules .= "\$(srcdir)/$headerfile: \$(srcdir)/${derived}_vala.stamp\n".
- "\t\@if test -f \$@; then :; else \\\n".
- "\t rm -f \$(srcdir)/${derived}_vala.stamp; \\\n".
- "\t \$(am__cd) \$(srcdir) && \$(MAKE) \$(AM_MAKEFLAGS) ${derived}_vala.stamp; \\\n".
- "\tfi\n";
+ $output_rules .= "\$(srcdir)/$headerfile: \$(srcdir)/${derived}_vala.stamp\n"
+ . "\t\@if test -f \$@; then :; else rm -f \$(srcdir)/${derived}_vala.stamp; fi\n"
+ . "\t\@if test -f \$@; then :; else \\\n"
+ . "\t \$(am__cd) \$(srcdir) && \$(MAKE) \$(AM_MAKEFLAGS) ${derived}_vala.stamp; \\\n"
+ . "\tfi\n";
# valac is not used when building from dist tarballs
# distribute the generated files
$output_rules .=
"$condstr${header}: $output\n"
# Recover from removal of $header
- . "$condstr\t\@if test ! -f \$@; then \\\n"
- . "$condstr\t rm -f $output; \\\n"
- . "$condstr\t \$(MAKE) \$(AM_MAKEFLAGS) $output; \\\n"
- . "$condstr\telse :; fi\n";
+ . "$condstr\t\@if test ! -f \$@; then rm -f $output; else :; fi\n"
+ . "$condstr\t\@if test ! -f \$@; then \$(MAKE) \$(AM_MAKEFLAGS) $output; else :; fi\n";
}
# Distribute the generated file, unless its .y source was
# listed in a nodist_ variable. (&handle_source_transform
################################################################
+ # Helper function for usage().
+ sub print_autodist_files (@)
+ {
+ my @lcomm = sort (&uniq (@_));
+
+ my @four;
+ format USAGE_FORMAT =
+ @<<<<<<<<<<<<<<<< @<<<<<<<<<<<<<<<< @<<<<<<<<<<<<<<<< @<<<<<<<<<<<<<<<<
+ $four[0], $four[1], $four[2], $four[3]
+ .
+ local $~ = "USAGE_FORMAT";
+
+ my $cols = 4;
+ my $rows = int(@lcomm / $cols);
+ my $rest = @lcomm % $cols;
+
+ if ($rest)
+ {
+ $rows++;
+ }
+ else
+ {
+ $rest = $cols;
+ }
+
+ for (my $y = 0; $y < $rows; $y++)
+ {
+ @four = ("", "", "", "");
+ for (my $x = 0; $x < $cols; $x++)
+ {
+ last if $y + 1 == $rows && $x == $rest;
+
+ my $idx = (($x > $rest)
+ ? ($rows * $rest + ($rows - 1) * ($x - $rest))
+ : ($rows * $x));
+
+ $idx += $y;
+ $four[$x] = $lcomm[$idx];
+ }
+ write;
+ }
+ }
+
+
# Print usage information.
sub usage ()
{
";
Automake::ChannelDefs::usage;
- my ($last, @lcomm);
- $last = '';
- foreach my $iter (sort ((@common_files, @common_sometimes)))
- {
- push (@lcomm, $iter) unless $iter eq $last;
- $last = $iter;
- }
-
- my @four;
- print "\nFiles which are automatically distributed, if found:\n";
- format USAGE_FORMAT =
- @<<<<<<<<<<<<<<<< @<<<<<<<<<<<<<<<< @<<<<<<<<<<<<<<<< @<<<<<<<<<<<<<<<<
- $four[0], $four[1], $four[2], $four[3]
- .
- $~ = "USAGE_FORMAT";
-
- my $cols = 4;
- my $rows = int(@lcomm / $cols);
- my $rest = @lcomm % $cols;
-
- if ($rest)
- {
- $rows++;
- }
- else
- {
- $rest = $cols;
- }
-
- for (my $y = 0; $y < $rows; $y++)
- {
- @four = ("", "", "", "");
- for (my $x = 0; $x < $cols; $x++)
- {
- last if $y + 1 == $rows && $x == $rest;
-
- my $idx = (($x > $rest)
- ? ($rows * $rest + ($rows - 1) * ($x - $rest))
- : ($rows * $x));
-
- $idx += $y;
- $four[$x] = $lcomm[$idx];
- }
- write;
- }
+ print "\nFiles automatically distributed if found " .
+ "(always):\n";
+ print_autodist_files @common_files;
+ print "\nFiles automatically distributed if found " .
+ "(under certain conditions):\n";
+ print_autodist_files @common_sometimes;
print '
Report bugs to <@PACKAGE_BUGREPORT@>.
{
print <<EOF;
automake (GNU $PACKAGE) $VERSION
- Copyright (C) 2010 Free Software Foundation, Inc.
+ Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl-2.0.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Makefiles from template files.
Copyright @copyright{} 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
- 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation,
- Inc.
+ 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
+ Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
@insertcopying
@end titlepage
+ @contents
@c We use the following macros to define indices:
@c @cindex concepts, and anything that does not fit elsewhere
@c Put the macros in the function index.
@syncodeindex ac fn
- @c Put everything else into one index (arbitrarily chosen to be the concept index).
+ @c Put everything else into one index (arbitrarily chosen to be the
+ @c concept index).
@syncodeindex op cp
@syncodeindex tr cp
@syncodeindex cm cp
* Generalities:: General ideas
* Examples:: Some example packages
* Invoking Automake:: Creating a Makefile.in
- * configure:: Scanning configure.ac or configure.in
+ * configure:: Scanning configure.ac, using aclocal
* Directories:: Declaring subdirectories
* Programs:: Building programs and libraries
* Other Objects:: Other derived objects
* Miscellaneous:: Miscellaneous rules
* Include:: Including extra files in an Automake template
* Conditionals:: Conditionals
+ * Silencing Make:: Obtain less verbose output from @command{make}
* Gnits:: The effect of @option{--gnu} and @option{--gnits}
* Cygnus:: The effect of @option{--cygnus}
* Not Enough:: When Automake is not Enough
A Small Hello World
* Creating amhello:: Create @file{amhello-1.0.tar.gz} from scratch
- * amhello Explained:: @file{configure.ac} and @file{Makefile.am} explained
+ * amhello's configure.ac Setup Explained::
+ * amhello's Makefile.am Setup Explained::
General ideas
* General Operation:: General operation of Automake
* Strictness:: Standards conformance checking
* Uniform:: The Uniform Naming Scheme
- * Canonicalization:: How derived variables are named
* Length Limitations:: Staying below the command line length limit
+ * Canonicalization:: How derived variables are named
* User Variables:: Variables reserved for the user
* Auxiliary Programs:: Programs automake might require
* Complete:: A simple example, start to finish
* true:: Building true and false
- Scanning @file{configure.ac}
+ Scanning @file{configure.ac}, using @command{aclocal}
* Requirements:: Configuration requirements
* Optional:: Other things Automake recognizes
* Java Support:: Compiling Java sources
* Vala Support:: Compiling Vala sources
* Support for Other Languages:: Compiling other languages
- * ANSI:: Automatic de-ANSI-fication (obsolete)
+ * ANSI:: Automatic de-ANSI-fication (deprecated, soon to be removed)
* Dependencies:: Automatic dependency tracking
* EXEEXT:: Support for executable extensions
* Program Sources:: Defining program sources
* Linking:: Linking with libraries or extra objects
* Conditional Sources:: Handling conditional sources
- * Conditional Programs:: Building program conditionally
+ * Conditional Programs:: Building a program conditionally
Building a Shared Library
* LTLIBOBJS:: Using $(LTLIBOBJS) and $(LTALLOCA)
* Libtool Issues:: Common Issues Related to Libtool's Use
+ Common Issues Related to Libtool's Use
+
+ * Error required file ltmain.sh not found:: The need to run libtoolize
+ * Objects created both with libtool and without:: Avoid a specific build race
+
Fortran 77 Support
* Preprocessing Fortran 77:: Preprocessing Fortran 77 sources
* Texinfo:: Texinfo
* Man Pages:: Man pages
- Installation
+ What Gets Installed
* Basics of Installation:: What gets installed where
* The Two Parts of Install:: Installing data and programs separately
* Staged Installs:: Installation in a temporary location
* Install Rules for the User:: Useful additional rules
- Distribution
+ What Goes in a Distribution
* Basics of Distribution:: Files distributed by default
* Fine-grained Distribution Control:: @code{dist_} and @code{nodist_} prefixes
* Checking the Distribution:: @samp{make distcheck} explained
* The Types of Distributions:: A variety of formats and compression methods
- Support for Test Suites
+ Support for test suites
* Simple Tests:: Listing programs and scripts in @code{TESTS}
* Simple Tests using parallel-tests:: More powerful test driver
* Usage of Conditionals:: Declaring conditional content
* Limits of Conditionals:: Enclosing complete statements
+ Silencing Make
+
+ * Make verbosity:: Make is verbose by default
+ * Tricks For Silencing Make:: Standard and generic ways to silence make
+ * Automake silent-rules Option:: How Automake can help in silencing make
+
When Automake Isn't Enough
* Extending:: Adding new rules or overriding existing ones.
* Multiple Outputs:: Writing rules for tools with many output files
* Hard-Coded Install Paths:: Installing to hard-coded locations
* Debugging Make Rules:: Strategies when things don't work as expected
+ * Reporting Bugs:: Feedback on bugs and feature requests
History of Automake
* Dependency Tracking Evolution:: Evolution of Automatic Dependency Tracking
* Releases:: Statistics about Automake Releases
- Dependency Tracking Evolution
+ Dependency Tracking in Automake
* First Take on Dependencies:: Precomputed dependency tracking
* Dependencies As Side Effects:: Update at developer compile time
* Dependencies for the User:: Update at user compile time
- * Techniques for Dependencies:: Alternative approaches
+ * Techniques for Dependencies:: Alternative approaches
* Recommendations for Tool Writers:: What tool writers can do to help
* Future Directions for Dependencies:: Languages Automake does not know
@cindex Reporting bugs
@cindex E-mail, bug reports
- Mail suggestions and bug reports for Automake to
- @email{@value{PACKAGE_BUGREPORT}}.
+ For more information on bug reports, @xref{Reporting Bugs}.
@node Autotools Introduction
@chapter An Introduction to the Autotools
VPATH builds have other interesting uses. One is to build the same
sources with multiple configurations. For instance:
+ @c Keep in sync with amhello-cflags.test.
@example
~ % @kbd{tar zxf ~/amhello-1.0.tar.gz}
~ % @kbd{cd amhello-1.0}
Here is how we could build @code{amhello-1.0} for
@code{i586-mingw32msvc} on a GNU/Linux PC.
+ @c Keep in sync with amhello-cross-compile.test.
@smallexample
~/amhello-1.0 % @kbd{./configure --build i686-pc-linux-gnu --host i586-mingw32msvc}
checking for a BSD-compatible install... /usr/bin/install -c
For instance here is how we could create a binary package containing a
snapshot of all the files to be installed.
+ @c Keep in sync with amhello-binpkg.test.
@example
~/amhello-1.0 % @kbd{./configure --prefix /usr}
@dots{}
dependency appears to have changed, the dependent files will be
rebuilt.
+ Automake generates code for automatic dependency tracking by default,
+ unless the developer chooses to override it; for more information,
+ @pxref{Dependencies}.
+
When @command{configure} is executed, you can see it probing each
compiler for the dependency mechanism it supports (several mechanisms
can be used):
meaning of the @file{configure.ac} and @file{Makefile.am} files read
by the Autotools.
+ @anchor{amhello Explained}
@menu
* Creating amhello:: Create @file{amhello-1.0.tar.gz} from scratch
- * amhello Explained:: @file{configure.ac} and @file{Makefile.am} explained
+ * amhello's configure.ac Setup Explained::
+ * amhello's Makefile.am Setup Explained::
@end menu
@node Creating amhello
direct you to the right manual when seeking answers.
- @node amhello Explained
- @subsection @file{amhello-1.0} Explained
+ @node amhello's configure.ac Setup Explained
+ @subsection @code{amhello}'s @file{configure.ac} Setup Explained
+
+ @cindex @file{configure.ac}, Hello World
Let us begin with the contents of @file{configure.ac}.
@command{autoscan} to Create @file{configure.ac}, autoconf, The
Autoconf Manual}).
+
+ @node amhello's Makefile.am Setup Explained
+ @subsection @code{amhello}'s @file{Makefile.am} Setup Explained
+
@cindex @file{Makefile.am}, Hello World
We now turn to @file{src/Makefile.am}. This file contains
The only important effect of this second line is therefore to install
@file{README} during @code{make install}.
+ One thing not covered in this example is accessing the installation
+ directory values (@pxref{Standard Directory Variables}) from your
+ program code, that is, converting them into defined macros. For this,
+ @pxref{Defining Directories,,, autoconf, The Autoconf Manual}.
+
@node Generalities
@chapter General ideas
* General Operation:: General operation of Automake
* Strictness:: Standards conformance checking
* Uniform:: The Uniform Naming Scheme
- * Canonicalization:: How derived variables are named
* Length Limitations:: Staying below the command line length limit
+ * Canonicalization:: How derived variables are named
* User Variables:: Variables reserved for the user
* Auxiliary Programs:: Programs automake might require
@end menu
for compiling and linking programs to be generated.
@cindex Non-standard targets
- @cindex @code{cvs-dist}, non-standard example
- @trindex cvs-dist
+ @cindex @code{git-dist}, non-standard example
@trindex git-dist
The variable definitions and rules in the @file{Makefile.am} are
- copied verbatim into the generated file. This allows you to add
+ copied mostly verbatim into the generated file, with all variable
+ definitions preceding all rules. This allows you to add almost
arbitrary code into the generated @file{Makefile.in}. For instance,
the Automake distribution includes a non-standard rule for the
@code{git-dist} target, which the Automake maintainer uses to make
specified on the left. Automake will translate the operator into
an ordinary @samp{=} operator; @samp{+=} will thus work with any make program.
- @cindex indentation
- Further note that variable assignments should not be indented with
- @key{TAB} characters, use spaces if necessary. On the other hand,
- rule commands should be indented with a leading @key{TAB} character.
-
Automake tries to keep comments grouped with any adjoining rules or
variable definitions.
+ @cindex Limitations of automake parser
+ @cindex Automake parser, limitations of
+ @cindex indentation in Makefile.am
+ Generally, Automake is not particularly smart in the parsing of unusual
+ Makefile constructs, so you're advised to avoid fancy constructs or
+ ``creative'' use of whitespaces.
+ @c Keep this in sync with doc-parsing-buglets-tabs.test.
+ For example, @key{TAB} characters cannot be used between a target name
+ and the following ``@code{:}'' character, and variable assignments
+ shouldn't be indented with @key{TAB} characters.
+ @c Keep this in sync with doc-parsing-buglets-colneq-subst.test.
+ Also, using more complex macro in target names can cause trouble:
+
+ @example
+ % @kbd{cat Makefile.am}
+ $(FOO:=x): bar
+ % @kbd{automake}
+ Makefile.am:1: bad characters in variable name `$(FOO'
+ Makefile.am:1: `:='-style assignments are not portable
+ @end example
+
@cindex Make targets, overriding
@cindex Make rules, overriding
@cindex Overriding make rules
variables referenced in the definition. For example, if Automake is
looking at the content of @code{foo_SOURCES} in this snippet
+ @c Keep in sync with interp.test.
@example
xs = a.c b.c
foo_SOURCES = c.c $(xs)
@samp{bindir_PROGRAMS}.
Not every sort of object can be installed in every directory. Automake
- will flag those attempts it finds in error.
+ will flag those attempts it finds in error (but see below how to override
+ the check if you really need to).
Automake will also diagnose obvious misspellings in directory names.
@cindex Extending list of installation directories
For instance, the following snippet will install @file{file.xml} into
@samp{$(datadir)/xml}.
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
xmldir = $(datadir)/xml
xml_DATA = file.xml
@end example
+ This feature can also be used to override the sanity checks Automake
+ performs to diagnose suspicious directory/primary couples (in the
+ unlikely case these checks are undesirable, and you really know what
+ you're doing). For example, Automake would error out on this input:
+
+ @c Should be tested in primary-prefix-invalid-couples.test.
+ @example
+ # Forbidden directory combinations, automake will error out on this.
+ pkglib_PROGRAMS = foo
+ doc_LIBRARIES = libquux.a
+ @end example
+
+ @noindent
+ but it will succeed with this:
+
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
+ @example
+ # Work around forbidden directory combinations. Do not use this
+ # without a very good reason!
+ my_execbindir = $(pkglibdir)
+ my_doclibdir = $(docdir)
+ my_execbin_PROGRAMS = foo
+ my_doclib_LIBRARIES = libquux.a
+ @end example
+
+ The @samp{exec} substring of the @samp{my_execbindir} variable lets
+ the files be installed at the right time (@pxref{The Two Parts of
+ Install}).
+
@cindex @samp{noinst_} primary prefix, definition
@vindex noinst_
objects are not installed either.
The current primary names are @samp{PROGRAMS}, @samp{LIBRARIES},
- @samp{LISP}, @samp{PYTHON}, @samp{JAVA}, @samp{SCRIPTS}, @samp{DATA},
- @samp{HEADERS}, @samp{MANS}, and @samp{TEXINFOS}.
+ @samp{LTLIBRARIES}, @samp{LISP}, @samp{PYTHON}, @samp{JAVA},
+ @samp{SCRIPTS}, @samp{DATA}, @samp{HEADERS}, @samp{MANS}, and
+ @samp{TEXINFOS}.
@vindex PROGRAMS
@vindex LIBRARIES
+ @vindex LTLIBRARIES
@vindex LISP
@vindex PYTHON
@vindex JAVA
@noindent
may also be written as
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
data_DATA = file1 @dots{} file@var{N}
data2dir = $(datadir)
source in case you need more recent versions.
@table @code
+@item ar-lib
+This is a wrapper primarily for the Microsoft lib archiver, to make
+it more POSIX-like.
+
@item ansi2knr.c
@itemx ansi2knr.1
- These two files are used for de-ANSI-fication support (obsolete
- @pxref{ANSI}).
+ These two files are used for de-ANSI-fication support (they are
+ deprecated now, and @emph{will be removed} in the next major Automake
+ release; @pxref{ANSI}).
@item compile
This is a wrapper for compilers that do not accept options @option{-c}
and @option{-o} at the same time. It is only used when absolutely
-required. Such compilers are rare.
+required. Such compilers are rare, with the Microsoft C/C++ Compiler
+as the most notable exception. This wrapper also makes the following
+common options available for that compiler, while performing file name
+translation where needed: @option{-I}, @option{-L}, @option{-l},
+@option{-Wl,} and @option{-Xlinker}.
@item config.guess
@itemx config.sub
$(COMPILE) -DEXIT_CODE=1 -c true.c && mv true.o false.o
@end example
- Also, these explicit rules do not work if the obsolete de-ANSI-fication feature
- is used (@pxref{ANSI}). Supporting de-ANSI-fication requires a little
- more work:
-
- @example
- true_.o: true_.c false_.o
- $(COMPILE) -DEXIT_CODE=0 -c true_.c
-
- false_.o: true_.c
- $(COMPILE) -DEXIT_CODE=1 -c true_.c && mv true_.o false_.o
- @end example
-
As it turns out, there is also a much easier way to do this same task.
- Some of the above techniques are useful enough that we've kept the
+ Some of the above technique is useful enough that we've kept the
example in the manual. However if you were to build @code{true} and
@code{false} in real life, you would probably use per-program
compilation flags, like so:
+ @c Keep in sync with specflg7.test and specflg8.test.
@example
bin_PROGRAMS = false true
@end example
In this case Automake will cause @file{true.c} to be compiled twice,
- with different flags. De-ANSI-fication will work automatically. In
- this instance, the names of the object files would be chosen by
- automake; they would be @file{false-true.o} and @file{true-true.o}.
- (The name of the object files rarely matters.)
+ with different flags. In this instance, the names of the object files
+ would be chosen by automake; they would be @file{false-true.o} and
+ @file{true-true.o}. (The name of the object files rarely matters.)
@node Invoking Automake
@node configure
- @chapter Scanning @file{configure.ac}
+ @chapter Scanning @file{configure.ac}, using @command{aclocal}
@cindex @file{configure.ac}, scanning
@cindex Scanning @file{configure.ac}
+ @cindex Using @command{aclocal}
+ @cindex @command{aclocal}, using
Automake scans the package's @file{configure.ac} to determine certain
information about the package. Some @command{autoconf} macros are required
@command{automake} will not be able to fulfill this setup, and you will
have to complete the missing bits by hand. For instance, on
+ @c Keep in sync with output11.test.
@example
file=input
@dots{}
Similarly
+ @c Keep in sync with output11.test.
@example
file=output
file2=out:in
Automake will look for various helper scripts, such as
@file{install-sh}, in the directory named in this macro invocation.
@c This list is accurate relative to version 1.8
-(The full list of scripts is: @file{config.guess}, @file{config.sub},
-@file{depcomp}, @file{elisp-comp}, @file{compile}, @file{install-sh},
-@file{ltmain.sh}, @file{mdate-sh}, @file{missing}, @file{mkinstalldirs},
-@file{py-compile}, @file{texinfo.tex}, and @file{ylwrap}.) Not all
-scripts are always searched for; some scripts will only be sought if the
-generated @file{Makefile.in} requires them.
+(The full list of scripts is: @file{ar-lib}, @file{config.guess},
+@file{config.sub}, @file{depcomp}, @file{elisp-comp}, @file{compile},
+@file{install-sh}, @file{ltmain.sh}, @file{mdate-sh}, @file{missing},
+@file{mkinstalldirs}, @file{py-compile}, @file{texinfo.tex}, and
+@file{ylwrap}.) Not all scripts are always searched for; some scripts
+will only be sought if the generated @file{Makefile.in} requires them.
If @code{AC_CONFIG_AUX_DIR} is not given, the scripts are looked for in
their standard locations. For @file{mdate-sh},
of Automake required the use of @code{AM_CONFIG_HEADER}
(@pxref{Macros}); this is no longer the case.
- As for @code{AC_CONFIG_FILES} (@pxref{Requirements}), parts of the
+ As with @code{AC_CONFIG_FILES} (@pxref{Requirements}), parts of the
specification using shell variables will be ignored as far as
cleaning, distributing, and rebuilding is concerned.
if @code{AC_PATH_XTRA} is called.
@item AM_C_PROTOTYPES
- This is required when using the obsolete de-ANSI-fication feature; see
- @ref{ANSI}.
+ This is required when using the deprecated de-ANSI-fication feature;
+ @pxref{ANSI}. @emph{It will be removed} in the next major Automake
+ release.
@item AM_CONDITIONAL
This introduces an Automake conditional (@pxref{Conditionals}).
A macro file's name should end in @file{.m4}. Such files should be
installed in @file{$(datadir)/aclocal}. This is as simple as writing:
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
aclocaldir = $(datadir)/aclocal
aclocal_DATA = mymacro.m4 myothermacro.m4
current implementation, however it requires a stricter style from the
macro authors. Hopefully it is easy to revise the existing macros.
For instance,
+
@example
# bad style
AC_PREREQ(2.57)
AX_BAR
])
@end example
+
@noindent
should be rewritten as
+
@example
AC_DEFUN([AX_FOOBAR],
[AC_PREREQ([2.57])dnl
Check to see if function prototypes are understood by the compiler. If
so, define @samp{PROTOTYPES} and set the output variables @code{U} and
@code{ANSI2KNR} to the empty string. Otherwise, set @code{U} to
- @samp{_} and @code{ANSI2KNR} to @samp{./ansi2knr}. Automake uses these
- values to implement the obsolete de-ANSI-fication feature.
+ @samp{_} and @code{ANSI2KNR} to @samp{./ansi2knr}. Automake used these
+ values to implement the deprecated de-ANSI-fication feature; however,
+ support for @emph{that feature will be removed} in the next major Automake
+ release, and then @emph{these macros and variables will go away as well}.
@item AM_CONFIG_HEADER
@acindex AM_CONFIG_HEADER
@cindex @code{SUBDIRS} and @code{AM_CONDITIONAL}
@cindex @code{AM_CONDITIONAL} and @code{SUBDIRS}
- @c The test case for the setup described here is
- @c test/subdircond2.test
- @c Try to keep it in sync.
+ @c Keep in sync with subcond2.test.
@file{configure} should output the @file{Makefile} for each directory
and define a condition into which @file{opt/} should be built.
@cindex @code{SUBDIRS} and @code{AC_SUBST}
@cindex @code{AC_SUBST} and @code{SUBDIRS}
- @c The test case for the setup described here is
- @c test/subdircond3.test
- @c Try to keep it in sync.
+ @c Keep in sync with subcond3.test.
Another possibility is to define @code{MAYBE_OPT} from
@file{./configure} using @code{AC_SUBST}:
directory (@pxref{Uniform}). For instance, the last example could be
rewritten as follows:
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
imagesdir = $(pkgdatadir)/images
soundsdir = $(pkgdatadir)/sounds
* Java Support:: Compiling Java sources
* Vala Support:: Compiling Vala sources
* Support for Other Languages:: Compiling other languages
- * ANSI:: Automatic de-ANSI-fication (obsolete)
+ * ANSI:: Automatic de-ANSI-fication (deprecated, soon to be removed)
* Dependencies:: Automatic dependency tracking
* EXEEXT:: Support for executable extensions
@end menu
@vindex bin_PROGRAMS
@vindex sbin_PROGRAMS
@vindex libexec_PROGRAMS
- @vindex pkglib_PROGRAMS
+ @vindex pkglibexec_PROGRAMS
@vindex noinst_PROGRAMS
@vindex check_PROGRAMS
In a directory containing source that gets built into a program (as
opposed to a library or a script), the @code{PROGRAMS} primary is used.
Programs can be installed in @code{bindir}, @code{sbindir},
- @code{libexecdir}, @code{pkglibdir}, @code{pkglibexecdir}, or not at all
+ @code{libexecdir}, @code{pkglibexecdir}, or not at all
(@code{noinst_}). They can also be built only for @samp{make check}, in
which case the prefix is @samp{check_}.
select programs to be built. In this case you don't have to worry
about @samp{$(EXEEXT)} or @code{EXTRA_PROGRAMS}.
+ @c Keep in sync with exeext.test.
@example
bin_PROGRAMS = cpio pax
if WANT_MT
@code{@var{library}_LIBADD} variable. This should be used for objects
determined by @command{configure}. Again from @code{cpio}:
+ @c Keep in sync with pr401c.test.
@example
libcpio_a_LIBADD = $(LIBOBJS) $(ALLOCA)
@end example
the link rule for these two libraries. Therefore the @option{-rpath}
argument must be explicitly supplied.
+ @c Keep in sync with ltcond.test.
@example
EXTRA_LTLIBRARIES = libfoo.la libbar.la
lib_LTLIBRARIES = $(WANTEDLIBS)
it's clear that both libraries will end up in @samp{$(libdir)} if they
are installed.
+ @c Keep in sync with ltcond.test.
@example
lib_LTLIBRARIES =
if WANT_LIBFOO
@file{hello-linux.c} or @file{hello-generic.c} with the following
@file{Makefile.am}.
+ @c Keep in sync with ltcond2.test.
@example
lib_LTLIBRARIES = libhello.la
libhello_la_SOURCES = hello-common.c
Or we could simply use an Automake conditional as follows.
+ @c Keep in sync with ltcond2.test.
@example
lib_LTLIBRARIES = libhello.la
libhello_la_SOURCES = hello-common.c
Here is a sample setup merging libtool convenience libraries from
subdirectories into one main @file{libtop.la} library.
+ @c Keep in sync with ltconv.test.
@example
# -- Top-level Makefile.am --
SUBDIRS = sub1 sub2 @dots{}
@subsection Common Issues Related to Libtool's Use
@menu
- * Error required file ltmain.sh not found:: The need to run libtoolize
- * Objects created both with libtool and without:: Avoid a specific build race
+ * Error required file ltmain.sh not found:: The need to run libtoolize
+ * Objects created both with libtool and without:: Avoid a specific build race
@end menu
@node Error required file ltmain.sh not found
We already saw such an example in @ref{true}; this happens when all
the constituents of a target have already been compiled and just need
to be combined using a @code{_LDADD} variable. Then it is necessary
- to define an empty @code{_SOURCES} variable, so that @command{automake} does not
- compute a default.
+ to define an empty @code{_SOURCES} variable, so that @command{automake}
+ does not compute a default.
@example
bin_PROGRAMS = target
@code{AM_CONFIG_HEADER}). You can disable the default @option{-I}
options using the @option{nostdinc} option.
+ When a file to be included is generated during the build and not part
+ of a distribution tarball, its location is under @code{$(builddir)},
+ not under @code{$(srcdir)}. This matters especially for packages that
+ use header files placed in sub-directories and want to allow builds
+ outside the source tree (@pxref{VPATH Builds}). In that case we
+ recommend to use a pair of @option{-I} options, such as, e.g.,
+ @samp{-Isome/subdir -I$(srcdir)/some/subdir} or
+ @samp{-I$(top_builddir)/some/subdir -I$(top_srcdir)/some/subdir}.
+ Note that the reference to the build tree should come before the
+ reference to the source tree, so that accidentally leftover generated
+ files in the source directory are ignored.
+
@code{AM_CPPFLAGS} is ignored in preference to a per-executable (or
per-library) @code{_CPPFLAGS} variable if it is defined.
@code{AM_YFLAGS} is usually used to pass the @option{-d} option to
@command{yacc}. Automake knows what this means and will automatically
adjust its rules to update and distribute the header file built by
- @samp{yacc -d}. What Automake cannot guess, though, is where this
+ @samp{yacc -d}@footnote{Please note that @command{automake} recognizes
+ @option{-d} in @code{AM_YFLAGS} only if it is not clustered with other
+ options; for example, it won't be recognized if @code{AM_YFLAGS} is
+ @option{-dt}, but it will be if @code{AM_YFLAGS} is @option{-d -t} or
+ @option{-d -t}}.
+ What Automake cannot guess, though, is where this
header will be used: it is up to you to ensure the header gets built
before it is first used. Typically this is necessary in order for
dependency tracking to work when the header is included by another
@cindex Java support
@cindex Support for Java
- Automake includes support for compiled Java, using @command{gcj}, the Java
- front end to the GNU Compiler Collection.
+ Automake includes support for natively compiled Java, using @command{gcj},
+ the Java front end to the GNU Compiler Collection (preliminary support
+ for compiling Java to bytecode using the @command{javac} compiler is
+ also present; @pxref{Java}).
Any package including Java code to be compiled must define the output
variable @code{GCJ} in @file{configure.ac}; the variable @code{GCJFLAGS}
@node ANSI
- @section Automatic de-ANSI-fication
+ @section Automatic de-ANSI-fication (deprecated, soon to be removed)
@cindex de-ANSI-fication, defined
- The features described in this section are obsolete; you should not
- used any of them in new code, and they may be withdrawn in future
- Automake releases.
+ @emph{The features described in this section are deprecated; you must
+ not use any of them in new code, and remove their use from older but
+ still maintained code: they will be withdrawn in the next major
+ Automake release.}
When the C language was standardized in 1989, there was a long
transition period where package developers needed to worry about
current directory.
Note that automatic de-ANSI-fication will not work when the package is
- being built for a different host architecture. That is because @command{automake}
- currently has no way to build @command{ansi2knr} for the build machine.
+ being built for a different host architecture. That is because
+ @command{automake} currently has no way to build @command{ansi2knr}
+ for the build machine.
@c FIXME: this paragraph might be better moved to an `upgrading' section.
@cindex @code{LTLIBOBJS} and @code{ansi2knr}
@section Automatic dependency tracking
As a developer it is often painful to continually update the
- @file{Makefile.in} whenever the include-file dependencies change in a
+ @file{Makefile.am} whenever the include-file dependencies change in a
project. Automake supplies a way to automatically track dependency
changes (@pxref{Dependency Tracking}).
The targets Automake generates are likewise given the @samp{$(EXEEXT)}
extension.
- The variables @code{TESTS} and @code{XFAIL_TESTS} (@pxref{Simple Tests}) are also
- rewritten if they contain filenames that have been declared as programs
- in the same @file{Makefile}. (This is mostly useful when some programs
- from @code{check_PROGRAMS} are listed in @code{TESTS}.)
+ The variables @code{TESTS} and @code{XFAIL_TESTS} (@pxref{Simple Tests})
+ are also rewritten if they contain filenames that have been declared as
+ programs in the same @file{Makefile}. (This is mostly useful when some
+ programs from @code{check_PROGRAMS} are listed in @code{TESTS}.)
However, Automake cannot apply this rewriting to @command{configure}
substitutions. This means that if you are conditionally building a
There are two ways to avoid byte-compiling. Historically, we have
recommended the following construct.
+
@example
lisp_LISP = file1.el file2.el
ELCFILES =
@end example
+
@noindent
@code{ELCFILES} is an internal Automake variable that normally lists
all @file{.elc} files that must be byte-compiled. Automake defines
@code{ELCFILES} automatically from @code{lisp_LISP}. Emptying this
variable explicitly prevents byte-compilation.
- Since Automake 1.8, we now recommend using @code{lisp_DATA} instead. As
- in
+ Since Automake 1.8, we now recommend using @code{lisp_DATA} instead:
+
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
lisp_DATA = file1.el file2.el
@end example
@cindex @code{JAVA} primary, defined
@cindex Primary variable, @code{JAVA}
- Automake provides some minimal support for Java compilation with the
- @code{JAVA} primary.
+ Automake provides some minimal support for Java bytecode compilation with
+ the @code{JAVA} primary (in addition to the support for compiling Java to
+ native machine code; @pxref{Java Support}).
Any @file{.java} files listed in a @code{_JAVA} variable will be
compiled with @code{JAVAC} at build time. By default, @file{.java}
Here is a typical setup for distributing @file{.java} files and
installing the @file{.class} files resulting from their compilation.
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
javadir = $(datadir)/java
dist_java_JAVA = a.java b.java @dots{}
that will determine some Python-related directory variables (see
below). If you have called @code{AM_PATH_PYTHON} from
@file{configure.ac}, then you may use the variables
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@code{python_PYTHON} or @code{pkgpython_PYTHON} to list Python source
files in your @file{Makefile.am}, depending on where you want your files
installed (see the definitions of @code{pythondir} and
@code{pkgpythondir} below).
- @defmac AM_PATH_PYTHON (@ovar{version}, @ovar{action-if-found}, @ovar{action-if-not-found})
+ @defmac AM_PATH_PYTHON (@ovar{version}, @ovar{action-if-found},
+ @ovar{action-if-not-found})
Search for a Python interpreter on the system. This macro takes three
optional arguments. The first argument, if present, is the minimum
AM_PATH_PYTHON([2.5],, [:])
@end example
+ If the @env{PYTHON} variable is set when @code{AM_PATH_PYTHON} is
+ called, then that will be the only Python interpreter that is tried.
+
@code{AM_PATH_PYTHON} creates the following output variables based on
the Python installation found during configuration.
@end defmac
as follows.
@example
- AM_PATH_PYTHON(,, [:])
- AM_CONDITIONAL([HAVE_PYTHON], [test "$PYTHON" != :])
+ AM_PATH_PYTHON(,, [:])
+ AM_CONDITIONAL([HAVE_PYTHON], [test "$PYTHON" != :])
@end example
@item PYTHON_VERSION
should be installed. An extension module written in C could be declared
as follows to Automake:
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
@example
pyexec_LTLIBRARIES = quaternion.la
- quaternion_SOURCES = quaternion.c support.c support.h
+ quaternion_la_SOURCES = quaternion.c support.c support.h
quaternion_la_LDFLAGS = -avoid-version -module
@end example
@samp{$(AM_MAKEINFOHTMLFLAGS)} is used when building @file{.html}
files.
+ @c Keep in sync with txinfo21.test.
For instance, the following setting can be used to obtain one single
@file{.html} file per manual, without node separators.
@example
For instance, @code{data_DATA} files are installed by @code{install-data},
while @code{bin_PROGRAMS} files are installed by @code{install-exec}.
- Any variable using a user-defined directory prefix with @samp{exec} in
- the name (e.g., @code{myexecbin_PROGRAMS}) is installed by
- @code{install-exec}. All other user-defined prefixes are installed by
- @code{install-data}.
+ Any variable using a user-defined directory prefix with
+ @samp{exec} in the name (e.g.,
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
+ @code{myexecbin_PROGRAMS}) is installed by @code{install-exec}. All
+ other user-defined prefixes are installed by @code{install-data}.
@node Extending Installation
@section Extending Installation
@cmindex include
For the most part, the files to distribute are automatically found by
Automake: all source files are automatically included in a distribution,
- as are all @file{Makefile.am}s and @file{Makefile.in}s. Automake also
+ as are all @file{Makefile.am} and @file{Makefile.in} files. Automake also
has a built-in list of commonly used files that are automatically
included if they are found in the current directory (either physically,
- or as the target of a @file{Makefile.am} rule). This list is printed by
- @samp{automake --help}. Also, files that are read by @command{configure}
+ or as the target of a @file{Makefile.am} rule); this list is printed by
+ @samp{automake --help}. Note that some files in this list are actually
+ distributed only if other certain conditions hold (for example,
+ @c Keep in sync with autodist-config-headers.test.
+ the @file{config.h.top} and @file{config.h.bot} files are automatically
+ distributed only if, e.g., @samp{AC_CONFIG_HEADERS([config.h])} is used
+ in @file{configure.ac}). Also, files that are read by @command{configure}
(i.e.@: the source files corresponding to the files specified in various
Autoconf macros such as @code{AC_CONFIG_FILES} and siblings) are
- automatically distributed. Files included in @file{Makefile.am}s (using
+ automatically distributed. Files included in a @file{Makefile.am} (using
@code{include}) or in @file{configure.ac} (using @code{m4_include}), and
helper scripts installed with @samp{automake --add-missing} are also
distributed.
You can also mention a directory in @code{EXTRA_DIST}; in this case the
entire directory will be recursively copied into the distribution.
Please note that this will also copy @emph{everything} in the directory,
- including CVS/RCS version control files. We recommend against using
- this feature.
+ including, e.g., Subversion's @file{.svn} private directories or CVS/RCS
+ version control files. We recommend against using this feature.
@vindex SUBDIRS
@vindex DIST_SUBDIRS
EXTRA_DIST = doc
dist-hook:
- rm -rf `find $(distdir)/doc -name CVS`
+ rm -rf `find $(distdir)/doc -type d -name .svn`
@end example
@vindex distdir
(@pxref{VPATH Builds}), run the test suite, and finally make another
tarball to ensure the distribution is self-contained.
+ @vindex AM_DISTCHECK_CONFIGURE_FLAGS
@vindex DISTCHECK_CONFIGURE_FLAGS
Building the package involves running @samp{./configure}. If you need
to supply additional flags to @command{configure}, define them in the
- @code{DISTCHECK_CONFIGURE_FLAGS} variable, either in your top-level
- @file{Makefile.am}, or on the command line when invoking @command{make}.
+ @code{AM_DISTCHECK_CONFIGURE_FLAGS} variable in your top-level
+ @file{Makefile.am}. The user can still extend or override the flags
+ provided there by defining the @code{DISTCHECK_CONFIGURE_FLAGS} variable,
+ on the command line when invoking @command{make}.
+
+ Still, developers are encouraged to strive to make their code buildable
+ without requiring any special configure option; thus, in general, you
+ shouldn't define @code{AM_DISTCHECK_CONFIGURE_FLAGS}. However, there
+ might be few scenarios in which the use of this variable is justified.
+ GNU @command{m4} offers an example. GNU @command{m4} configures by
+ default with its experimental and seldom used "changeword" feature
+ disabled; so in its case it is useful to have @command{make distcheck}
+ run configure with the @option{--with-changeword} option, to ensure that
+ the code for changeword support still compiles correctly.
+ GNU @command{m4} also employs the @code{AM_DISTCHECK_CONFIGURE_FLAGS}
+ variable to stress-test the use of @option{--program-prefix=g}, since at
+ one point the @command{m4} build system had a bug where @command{make
+ installcheck} was wrongly assuming it could blindly test "@command{m4}",
+ rather than the just-installed "@command{gm4}".
@trindex distcheck-hook
If the @code{distcheck-hook} rule is defined in your top-level
anything, though as always caution is advised. Generally this hook is
used to check for potential distribution errors not caught by the
standard mechanism. Note that @code{distcheck-hook} as well as
- @code{DISTCHECK_CONFIGURE_FLAGS} are not honored in a subpackage
- @file{Makefile.am}, but the @code{DISTCHECK_CONFIGURE_FLAGS} are
- passed down to the @command{configure} script of the subpackage.
+ @code{AM_DISTCHECK_CONFIGURE_FLAGS} and @code{DISTCHECK_CONFIGURE_FLAGS}
+ are not honored in a subpackage @file{Makefile.am}, but the flags from
+ @code{AM_DISTCHECK_CONFIGURE_FLAGS} and @code{DISTCHECK_CONFIGURE_FLAGS}
+ are passed down to the @command{configure} script of the subpackage.
@trindex distcleancheck
@vindex DISTCLEANFILES
been cleaned because they are also part of the distribution, add the
following definition instead:
+ @c Keep in sync with distcleancheck.test.
@example
distcleancheck_listfiles = \
find . -type f -exec sh -c 'test -f $(srcdir)/$$1 || echo $$1' \
@samp{AM_COLOR_TESTS=no}, or force colored output even without a connecting
terminal with @samp{AM_COLOR_TESTS=always}.
+ Note that the semantics of some @command{make} implementations when used
+ in parallel mode (@pxref{Parallel make,,, autoconf, The Autoconf Manual})
+ can cause the automatic detection of a connection to a capable terminal
+ to fail. In that case, you can still resort to the use of
+ @samp{AM_COLOR_TESTS=always}.
+
@vindex TESTS
@vindex TESTS_ENVIRONMENT
The variable @code{TESTS_ENVIRONMENT} can be used to set environment
set in the rule. If all your test programs are scripts, you can also
set @code{TESTS_ENVIRONMENT} to an invocation of the shell (e.g.
@samp{$(SHELL) -x} can be useful for debugging the tests), or any other
- interpreter. For instance the following setup is used by the Automake
- package to run four tests in Perl.
+ interpreter. For instance, the following setup may be used to run tests
+ with Perl:
+
+ @c Keep in sync with tests-environment-backcompat.test.
@example
- TESTS_ENVIRONMENT = $(PERL) -Mstrict -I $(top_srcdir)/lib -w
- TESTS = Condition.pl DisjConditions.pl Version.pl Wrap.pl
+ TESTS_ENVIRONMENT = $(PERL) -Mstrict -w
+ TESTS = foo.pl bar.pl baz.pl
@end example
+ Note that the @option{parallel-tests} driver provides a more elegant
+ way to achieve the same effect, freeing the @code{TESTS_ENVIRONMENT}
+ variable for the user to override (@pxref{Simple Tests using
+ parallel-tests}).
+
@cindex Tests, expected failure
@cindex Expected test failure
+ @vindex XFAIL_TESTS
You may define the variable @code{XFAIL_TESTS} to a list of tests
(usually a subset of @code{TESTS}) that are expected to fail. This will
reverse the result of those tests.
- @vindex XFAIL_TESTS
Automake ensures that each file listed in @code{TESTS} is built before
any tests are run; you can list both source and derived programs (or
registered extension, the variables @code{LOG_COMPILER},
@code{AM_LOG_FLAGS}, and @code{LOG_FLAGS} may be used. For example,
+ @c Keep in sync with parallel-tests-log-compiler-example.test.
@example
TESTS = foo.pl bar.py baz
TEST_EXTENSIONS = .pl .py
env TESTS="foo.test bar.test" make -e check
@end example
+ Note however that the command above will unconditionally overwrite the
+ @file{test-suite.log} file, thus clobbering the recorded results
+ of any previous testsuite run. This might be undesirable for packages
+ whose testsuite takes long time to execute. Luckily, this problem can
+ easily be avoided by overriding also @code{TEST_SUITE_LOG} at runtime;
+ for example,
+
+ @c Keep in sync with parallel-tests-log-override-2.test.
+ @example
+ env TEST_SUITE_LOG=partial.log TESTS="..." make -e check
+ @end example
+
+ will write the result of the partial testsuite runs to the
+ @file{partial.log}, without touching @file{test-suite.log}.
+
@item
You can set the @code{TEST_LOGS} variable. By default, this variable is
computed at @command{make} run time from the value of @code{TESTS} as
env TEST_LOGS="foo.log $*" make -e check
@end example
+ The comments made above about @code{TEST_SUITE_LOG} overriding applies
+ here too.
+
@item
@vindex RECHECK_LOGS
@cindex lazy test execution
from @file{configure.ac}. For instance, the following statement will
cause @file{configure} to be rerun each time @file{version.sh} is
changed.
+
@example
AC_SUBST([CONFIG_STATUS_DEPENDENCIES], ['$(top_srcdir)/version.sh'])
@end example
+
@noindent
Note the @samp{$(top_srcdir)/} in the file name. Since this variable
is to be used in all @file{Makefile}s, its value must be sensible at
today. They are mainly used when the version of a package is updated
automatically by a script (e.g., in daily builds). Here is what some
old-style @file{configure.ac}s may look like:
+
@example
AC_INIT
. $srcdir/version.sh
AM_INIT_AUTOMAKE([name], $VERSION_NUMBER)
@dots{}
@end example
+
@noindent
Here, @file{version.sh} is a shell fragment that sets
@code{VERSION_NUMBER}. The problem with this example is that
straightforward, because shell variables are not allowed in
@code{AC_INIT}'s arguments. We recommend that @file{version.sh} be
replaced by an M4 file that is included by @file{configure.ac}:
+
@example
m4_include([version.m4])
AC_INIT([name], VERSION_NUMBER)
AM_INIT_AUTOMAKE
@dots{}
@end example
+
@noindent
Here @file{version.m4} could contain something like
@samp{m4_define([VERSION_NUMBER], [1.2])}. The advantage of this
@itemx @option{@var{path}/ansi2knr}
@cindex Option, @option{ansi2knr}
@opindex ansi2knr
- Turn on the obsolete de-ANSI-fication feature. @xref{ANSI}. If preceded by a
+ Turn on the deprecated de-ANSI-fication feature (@pxref{ANSI}). Note
+ that that feature and this option @emph{will be removed} in the next
+ major Automake release.
+
+ If preceded by a
path, the generated @file{Makefile.in} will look in the specified
directory to find the @file{ansi2knr} program. The path should be a
relative path to another directory in the same distribution (Automake
- currently does not check this).
+ does not check this).
@item @option{check-news}
@cindex Option, @option{check-news}
@cindex Option, @option{silent-rules}
@opindex silent-rules
Enable less verbose build rules. This can be used to let build rules
- output a status line of the form
-
+ output status lines of the form:
@example
- GEN @var{output-file}
+ GEN @var{output-file}
+ CC @var{object-file}
@end example
-
@noindent
instead of printing the command that will be executed to update
- @var{output-file}. It can also silence @command{libtool} output.
-
- To enable less verbose build rules, both the developer and the user
- of the package have to take a number of steps. The developer needs
- to do either of the following:
-
- @itemize @bullet
- @item
- Add the @option{silent-rules} option as argument to @code{AM_INIT_AUTOMAKE}.
- @item
- Call the @code{AM_SILENT_RULES} macro from within the @file{configure.ac}
- file.
- @end itemize
-
- It is not possible to instead specify @option{silent-rules} in a
- @file{Makefile.am} file.
-
- @cindex default verbosity for silent-rules
- If the developer has done either of the above, then the user of the
- package may influence the verbosity at @command{configure} run time as
- well as at @command{make} run time:
-
- @itemize @bullet
- @item
- @opindex --enable-silent-rules
- @opindex --disable-silent-rules
- Passing @option{--enable-silent-rules} to @command{configure} will cause
- build rules to be less verbose; the option @option{--disable-silent-rules}
- is the default and will cause normal verbose output.
- @item
- @vindex @code{V}
- At @command{make} run time, the default chosen at @command{configure}
- time may be overridden: @code{make V=1} will produce verbose output,
- @code{make V=0} less verbose output.
- @end itemize
-
- For portability to different @command{make} implementations, package authors
- are advised to not set the variable @code{V} inside the @file{Makefile.am}
- file, to allow the user to override the value for subdirectories as well.
-
- The current implementation of this feature relies on a non-POSIX, but in
- practice rather widely supported @file{Makefile} construct of nested
- variable expansion @samp{$(@var{var1}$(V))}. Do not use the
- @option{silent-rules} option if your package needs to build with
- @command{make} implementations that do not support it. The
- @option{silent-rules} option turns off warnings about recursive variable
- expansion, which are in turn enabled by @option{-Wportability}
- (@pxref{Invoking Automake}).
-
- @vindex @code{AM_V_GEN}
- @vindex @code{AM_V_at}
- @vindex @code{AM_DEFAULT_VERBOSITY}
- To extend the silent mode to your own rules, you have two choices:
-
- @itemize @bullet
- @item
- You can use the predefined variable @code{AM_V_GEN} as a prefix to
- commands that should output a status line in silent mode, and
- @code{AM_V_at} as a prefix to commands that should not output anything
- in silent mode. When output is to be verbose, both of these variables
- will expand to the empty string.
- @item
- You can add your own variables, so strings of your own choice are shown.
- The following snippet shows how you would define your own equivalent of
- @code{AM_V_GEN}:
-
- @example
- pkg_verbose = $(pkg_verbose_$(V))
- pkg_verbose_ = $(pkg_verbose_$(AM_DEFAULT_VERBOSITY))
- pkg_verbose_0 = @@echo GEN $@@;
-
- foo: foo.in
- $(pkg_verbose)cp $(srcdir)/foo.in $@@
- @end example
- @end itemize
+ @var{output-file} or to compile @var{object-file}. It can also
+ silence @command{libtool} output.
+ For more information about how to use, enable, or disable silent
+ rules, @pxref{Automake silent-rules Option}.
@item @option{std-options}
@cindex Options, @option{std-options}
the @samp{.idlC.cpp:} rule as an attempt to transform @file{.idlC} files into
@file{.cpp} files.
+ @c Keep in sync with suffix7.test.
@example
SUFFIXES = .idl C.cpp
.idlC.cpp:
Programs}, @pxref{Conditional Libtool Libraries}, @pxref{Conditional
Libtool Sources}).
+ @node Silencing Make
+ @chapter Silencing @command{make}
+
+ @cindex Silent @command{make}
+ @cindex Silencing @command{make}
+ @cindex Silent rules
+ @cindex Silent @command{make} rules
+
+ @menu
+ * Make verbosity:: Make is verbose by default
+ * Tricks For Silencing Make:: Standard and generic ways to silence make
+ * Automake silent-rules Option:: How Automake can help in silencing make
+ @end menu
+
+ @node Make verbosity
+ @section Make is verbose by default
+
+ Normally, when executing the set of rules associated with a target,
+ @command{make} prints each rule before it is executed. This behaviour,
+ while having been in place for a long time, and being even mandated by
+ the POSIX standard, starkly violates the ``silence is golden'' UNIX
+ principle@footnote{See also
+ @uref{http://catb.org/~esr/writings/taoup/html/ch11s09.html}.}:
+
+ @quotation
+ When a program has nothing interesting or surprising to say, it should
+ say nothing. Well-behaved Unix programs do their jobs unobtrusively,
+ with a minimum of fuss and bother. Silence is golden.
+ @end quotation
+
+ In fact, while such verbosity of @command{make} can theoretically be
+ useful to track bugs and understand reasons of failures right away, it
+ can also hide warning and error messages from @command{make}-invoked
+ tools, drowning them in a flood of uninteresting and seldom useful
+ messages, and thus allowing them to go easily undetected.
+
+ This problem can be very annoying, especially for developers, who usually
+ know quite well what's going on behind the scenes, and for whom the
+ verbose output from @command{make} ends up being mostly noise that hampers
+ the easy detection of potentially important warning messages.
+
+ @node Tricks For Silencing Make
+ @section Standard and generic ways to silence make
+
+ Here we describe some common idioms/tricks to obtain a quieter make
+ output, with their relative advantages and drawbacks. In the next
+ section (@ref{Automake silent-rules Option}) we'll see how Automake
+ can help in this respect.
+
+ @itemize @bullet
+
+ @item @command{make -s}
+
+ This simply causes @command{make} not to print @emph{any} rule before
+ executing it.
+
+ The @option{-s} flag is mandated by POSIX, universally supported, and
+ its purpose and function are easy to understand.
+
+ But it also has its serious limitations too. First of all, it embodies
+ an ``all or nothing'' strategy, i.e., either everything is silenced, or
+ nothing is; this lack of granularity can sometimes be a fatal flaw.
+ Moreover, when the @option{-s} flag is used, the @command{make} output
+ might turn out to be too much terse; in case of errors, the user won't
+ be able to easily see what rule or command have caused them, or even,
+ in case of tools with poor error reporting, what the errors were!
+
+ @item @command{make >/dev/null || make}
+
+ Apparently, this perfectly obeys the ``silence is golden'' rule: warnings
+ from stderr are passed through, output reporting is done only in case of
+ error, and in that case it should provide a verbose-enough report to allow
+ an easy determination of the error location and causes.
+
+ However, calling @command{make} two times in a row might hide errors
+ (especially intermittent ones), or subtly change the expected semantic
+ of the @command{make} calls --- things these which can clearly make
+ debugging and error assessment very difficult.
+
+ @item @command{make --no-print-directory}
+
+ This is GNU @command{make} specific. When called with the
+ @option{--no-print-directory} option, GNU @command{make} will disable
+ printing of the working directory by invoked sub-@command{make}s (the
+ well-known ``@i{Entering/Leaving directory ...}'' messages). This helps
+ to decrease the verbosity of the output, but experience has shown that
+ it can also often render debugging considerably harder in projects using
+ deeply-nested @command{make} recursion.
+
+ As an aside, notice that the @option{--no-print-directory} option is
+ automatically activated if the @option{-s} flag is used.
+
+ @c TODO: Other tricks?
+ @c TODO: Maybe speak about the @code{.SILENT} target?
+ @c TODO: - Pros: More granularity on what to silence.
+ @c TODO: - Cons: No easy way to temporarily override.
+
+ @end itemize
+
+ @node Automake silent-rules Option
+ @section How Automake can help in silencing make
+
+ The tricks and idioms for silencing @command{make} described in the
+ previous section can be useful from time to time, but we've seen that
+ they all have their serious drawbacks and limitations. That's why
+ automake provides support for a more advanced and flexible way of
+ obtaining quieter output from @command{make}: the @option{silent-rules}
+ mode.
+
+ @c TODO: Maybe describe in brief the precedent set by the build system
+ @c of the Linux Kernel, from which Automake took inspiration ... Links?
+
+ To give the gist of what @option{silent-rules} can do, here is a simple
+ comparison between a typical @command{make} output (where silent rules
+ are disabled) and one with silent rules enabled:
+
+ @example
+ % @kbd{cat Makefile.am}
+ bin_PROGRAMS = foo
+ foo_SOURCES = main.c func.c
+ % @kbd{cat main.c}
+ int main (void) @{ return func (); @} /* func used undeclared */
+ % @kbd{cat func.c}
+ int func (void) @{ int i; return i; @} /* i used uninitialized */
+
+ @i{The make output is by default very verbose. This causes warnings
+ from the compiler to be somewhat hidden, and not immediate to spot.}
+ % @kbd{make CFLAGS=-Wall}
+ gcc -DPACKAGE_NAME=\"foo\" -DPACKAGE_TARNAME=\"foo\" ...
+ -DPACKAGE_STRING=\"foo\ 1.0\" -DPACKAGE_BUGREPORT=\"\" ...
+ -DPACKAGE=\"foo\" -DVERSION=\"1.0\" -I. -Wall -MT main.o
+ -MD -MP -MF .deps/main.Tpo -c -o main.o main.c
+ main.c: In function ‘main’:
+ main.c:3:3: warning: implicit declaration of function ‘func’
+ mv -f .deps/main.Tpo .deps/main.Po
+ gcc -DPACKAGE_NAME=\"foo\" -DPACKAGE_TARNAME=\"foo\" ...
+ -DPACKAGE_STRING=\"foo\ 1.0\" -DPACKAGE_BUGREPORT=\"\" ...
+ -DPACKAGE=\"foo\" -DVERSION=\"1.0\" -I. -Wall -MT func.o
+ -MD -MP -MF .deps/func.Tpo -c -o func.o func.c
+ func.c: In function ‘func’:
+ func.c:4:3: warning: ‘i’ used uninitialized in this function
+ mv -f .deps/func.Tpo .deps/func.Po
+ gcc -Wall -o foo main.o func.o
+
+ @i{Clean up, so that we we can rebuild everything from scratch.}
+ % @kbd{make clean}
+ test -z "foo" || rm -f foo
+ rm -f *.o
+
+ @i{Silent rules enabled: the output is minimal but informative. In
+ particular, the warnings from the compiler stick out very clearly.}
+ % @kbd{make V=0 CFLAGS=-Wall}
+ CC main.o
+ main.c: In function ‘main’:
+ main.c:3:3: warning: implicit declaration of function ‘func’
+ CC func.o
+ func.c: In function ‘func’:
+ func.c:4:3: warning: ‘i’ used uninitialized in this function
+ CCLD foo
+ @end example
+
+ @cindex silent-rules and libtool
+ Also, in projects using @command{libtool}, the use of silent rules can
+ automatically enable the @command{libtool}'s @option{--silent} option:
+
+ @example
+ % @kbd{cat Makefile.am}
+ lib_LTLIBRARIES = libx.la
+
+ % @kbd{make # Both make and libtool are verbose by default.}
+ ...
+ libtool: compile: gcc -DPACKAGE_NAME=\"foo\" ... -DLT_OBJDIR=\".libs/\"
+ -I. -g -O2 -MT libx.lo -MD -MP -MF .deps/libx.Tpo -c libx.c -fPIC
+ -DPIC -o .libs/libx.o
+ mv -f .deps/libx.Tpo .deps/libx.Plo
+ /bin/sh ./libtool --tag=CC --mode=link gcc -g -O2 -o libx.la -rpath
+ /usr/local/lib libx.lo
+ libtool: link: gcc -shared .libs/libx.o -Wl,-soname -Wl,libx.so.0
+ -o .libs/libx.so.0.0.0
+ libtool: link: cd .libs && rm -f libx.so && ln -s libx.so.0.0.0 libx.so
+ ...
+
+ % @kbd{make V=0}
+ CC libx.lo
+ CCLD libx.la
+ @end example
+
+ Let's now see how the @option{silent-rules} mode interfaces with the
+ package developer and the package user.
+
+ To enable the use of @option{silent-rules} in his package, a developer
+ needs to do either of the following:
+
+ @itemize @bullet
+ @item
+ Add the @option{silent-rules} option as argument to @code{AM_INIT_AUTOMAKE}.
+ @item
+ Call the @code{AM_SILENT_RULES} macro from within the @file{configure.ac}
+ file.
+ @end itemize
+
+ It is not possible to instead specify @option{silent-rules} in a
+ @file{Makefile.am} file.
+
+ If the developer has done either of the above, then the user of the
+ package may influence the verbosity at @command{configure} run time as
+ well as at @command{make} run time:
+
+ @itemize @bullet
+ @item
+ @opindex --enable-silent-rules
+ @opindex --disable-silent-rules
+ Passing @option{--enable-silent-rules} to @command{configure} will cause
+ build rules to be less verbose; the option @option{--disable-silent-rules}
+ will cause normal verbose output.
+ @item
+ @vindex @code{V}
+ At @command{make} run time, the default chosen at @command{configure}
+ time may be overridden: @code{make V=1} will produce verbose output,
+ @code{make V=0} less verbose output.
+ @end itemize
+
+ @cindex default verbosity for silent-rules
+ Note that silent rules are @emph{disabled} by default; the user must
+ enable them explicitly at either @command{configure} run time or at
+ @command{make} run time. We think that this is a good policy, since
+ it provides the casual user with enough information to prepare a good
+ bug report in case anything breaks.
+
+ Still, notwithstanding the rationales above, a developer who wants to
+ make silent rules enabled by default in his own package can do so by
+ adding a @samp{yes} argument to the @code{AM_SILENT_RULES} call in
+ @file{configure.ac}. We advise against this approach, though.
+
+ @c Keep in sync with silent-configsite.test
+ Users who prefer to have silent rules enabled by default can edit their
+ @file{config.site} file to make the variable @code{enable_silent_rules}
+ default to @samp{yes}. This should still allow disabling silent rules
+ at @command{configure} time and at @command{make} time.
+
+ @c FIXME: there's really a need to specify this explicitly?
+ For portability to different @command{make} implementations, package authors
+ are advised to not set the variable @code{V} inside the @file{Makefile.am}
+ file, to allow the user to override the value for subdirectories as well.
+
+ The current implementation of this feature relies on a non-POSIX, but in
+ practice rather widely supported @file{Makefile} construct of nested
+ variable expansion @samp{$(@var{var1}$(V))}. Do not use the
+ @option{silent-rules} option if your package needs to build with
+ @command{make} implementations that do not support it. The
+ @option{silent-rules} option turns off warnings about recursive variable
+ expansion, which are in turn enabled by @option{-Wportability}
+ (@pxref{Invoking Automake}).
+
+ @vindex @code{AM_V_GEN}
+ @vindex @code{AM_V_at}
+ @vindex @code{AM_DEFAULT_VERBOSITY}
+ To extend the silent mode to your own rules, you have two choices:
+
+ @itemize @bullet
+ @item
+ You can use the predefined variable @code{AM_V_GEN} as a prefix to
+ commands that should output a status line in silent mode, and
+ @code{AM_V_at} as a prefix to commands that should not output anything
+ in silent mode. When output is to be verbose, both of these variables
+ will expand to the empty string.
+ @item
+ You can add your own variables, so strings of your own choice are shown.
+ The following snippet shows how you would define your own equivalent of
+ @code{AM_V_GEN}:
+
+ @example
+ pkg_verbose = $(pkg_verbose_$(V))
+ pkg_verbose_ = $(pkg_verbose_$(AM_DEFAULT_VERBOSITY))
+ pkg_verbose_0 = @@echo PKG-GEN $@@;
+
+ foo: foo.in
+ $(pkg_verbose)cp $(srcdir)/foo.in $@@
+ @end example
+
+ @end itemize
+
+ As a final note, observe that, even when silent rules are enabled,
+ the @option{--no-print-directory} option is still required with GNU
+ @command{make} if the ``@i{Entering/Leaving directory ...}'' messages
+ are to be disabled.
+
@node Gnits
@chapter The effect of @option{--gnu} and @option{--gnits}
implied.
@item
- The macros @code{AM_MAINTAINER_MODE} and @code{AM_CYGWIN32} are
- required.
+ The macro @code{AM_MAINTAINER_MODE} is required.
@item
The @code{check} target doesn't depend on @code{all}.
For instance, here is how you could install a versioned copy of a
program using @samp{$(LN_S)}:
+ @c Keep in sync with insthook.test
@example
install-exec-hook:
cd $(DESTDIR)$(bindir) && \
When writing @code{install-exec-hook} or @code{install-data-hook},
please bear in mind that the exec/data distinction is based on the
installation directory, not on the primary used (@pxref{The Two Parts of
- Install}). So a @code{foo_SCRIPTS} will be installed by
+ Install}).
+ @c Keep in sync with primary-prefix-couples-documented-valid.test.
+ So a @code{foo_SCRIPTS} will be installed by
@code{install-data}, and a @code{barexec_SCRIPTS} will be installed by
@code{install-exec}. You should define your hooks consequently.
@example
AM_INIT_AUTOMAKE([1.6.1]) dnl Require Automake 1.6.1 or better.
@end example
+
@noindent
or, in a particular @file{Makefile.am}:
@example
AUTOMAKE_OPTIONS = 1.6.1 # Require Automake 1.6.1 or better.
@end example
+
@noindent
Automake will print an error message if its version is
older than the requested version.
* Multiple Outputs:: Writing rules for tools with many output files
* Hard-Coded Install Paths:: Installing to hard-coded locations
* Debugging Make Rules:: Strategies when things don't work as expected
+ * Reporting Bugs:: Feedback on bugs and feature requests
@end menu
@node CVS
attempt to fix timestamps in a way that allows the build to continue.
For instance, @command{missing} will touch @file{configure} if
@command{autoconf} is not installed. When all distributed files are
- kept under CVS, this feature of @command{missing} allows a user
- @emph{with no maintainer tools} to build a package off CVS, bypassing
- any timestamp inconsistency implied by @samp{cvs update}.
+ kept under version control, this feature of @command{missing} allows a
+ user @emph{with no maintainer tools} to build a package off its version
+ control repository, bypassing any timestamp inconsistency (implied by
+ e.g.@: @samp{cvs update} or @samp{git clone}).
If the required tool is installed, @command{missing} will run it and
won't attempt to continue after failures. This is correct during
@code{AM_MAINTAINER_MODE} in all of his packages.
Still many people continue to use @code{AM_MAINTAINER_MODE}, because
- it helps them working on projects where all files are kept under CVS,
- and because @command{missing} isn't enough if you have the wrong
- version of the tools.
+ it helps them working on projects where all files are kept under version
+ control, and because @command{missing} isn't enough if you have the
+ wrong version of the tools.
@node Wildcards
false_SOURCES = generic.c
false_CPPFLAGS = -DEXIT_CODE=1
@end example
+
@noindent
Obviously the two programs are built from the same source, but it
would be bad if they shared the same object, because @file{generic.o}
data.h: data.foo data.c
foo data.foo
@end example
+
@noindent
therefore a parallel @command{make} will have to serialize the builds
of @file{data.c} and @file{data.h}, and will detect that the second is
fi
@end example
- However there are now two minor problems in this setup. One is related
+ However there are now three minor problems in this setup. One is related
to the timestamp ordering of @file{data.h}, @file{data.w},
- @file{data.x}, and @file{data.c}. The other one is a race condition
+ @file{data.x}, and @file{data.c}. Another one is a race condition
if a parallel @command{make} attempts to run multiple instances of the
- recover block at once.
+ recover block at once. Finally, the recursive rule breaks @samp{make -n}
+ when run with GNU @command{make} (as well as some other @command{make}
+ implementations), as it may remove @file{data.h} even when it should not
+ (@pxref{MAKE Variable, , How the @code{MAKE} Variable Works, make,
+ The GNU Make Manual}).
Let us deal with the first problem. @command{foo} outputs four files,
but we do not know in which order these files are created. Suppose
@@mv -f elc-temp $@@
$(ELCFILES): elc-stamp
- ## Recover from the removal of $@@
@@if test -f $@@; then :; else \
+ ## Recover from the removal of $@@
trap 'rm -rf elc-lock elc-stamp' 1 2 13 15; \
if mkdir elc-lock 2>/dev/null; then \
## This code is being executed by the first process.
while test -d elc-lock; do sleep 1; done; \
## Succeed if and only if the first process succeeded.
test -f elc-stamp; exit $$?; \
+ @c $$
fi; \
fi
@end example
+
+ These solutions all still suffer from the third problem, namely that
+ they break the promise that @samp{make -n} should not cause any actual
+ changes to the tree. For those solutions that do not create lock files,
+ it is possible to split the recover rules into two separate recipe
+ commands, one of which does all work but the recursion, and the
+ other invokes the recursive @samp{$(MAKE)}. The solutions involving
+ locking could act upon the contents of the @samp{MAKEFLAGS} variable,
+ but parsing that portably is not easy (@pxref{The Make Macro MAKEFLAGS,,,
+ autoconf, The Autoconf Manual}). Here is an example:
+
+ @example
+ ELFILES = one.el two.el three.el @dots{}
+ ELCFILES = $(ELFILES:=c)
+
+ elc-stamp: $(ELFILES)
+ @@rm -f elc-temp
+ @@touch elc-temp
+ $(elisp_comp) $(ELFILES)
+ @@mv -f elc-temp $@@
+
+ $(ELCFILES): elc-stamp
+ ## Recover from the removal of $@@
+ @@dry=; for f in x $$MAKEFLAGS; do \
+ case $$f in \
+ *=*|--*);; \
+ *n*) dry=:;; \
+ esac; \
+ done; \
+ if test -f $@@; then :; else \
+ $$dry trap 'rm -rf elc-lock elc-stamp' 1 2 13 15; \
+ if $$dry mkdir elc-lock 2>/dev/null; then \
+ ## This code is being executed by the first process.
+ $$dry rm -f elc-stamp; \
+ $(MAKE) $(AM_MAKEFLAGS) elc-stamp; \
+ $$dry rmdir elc-lock; \
+ else \
+ ## This code is being executed by the follower processes.
+ ## Wait until the first process is done.
+ while test -d elc-lock && test -z "$$dry"; do \
@c $$
+ sleep 1; \
+ done; \
+ ## Succeed if and only if the first process succeeded.
+ $$dry test -f elc-stamp; exit $$?; \
+ fi; \
+ fi
+ @end example
For completeness it should be noted that GNU @command{make} is able to
express rules with multiple output files using pattern rules
@end itemize
+ @node Reporting Bugs
+ @section Reporting Bugs
+
+ Most nontrivial software has bugs. Automake is no exception. Although
+ we cannot promise we can or will fix a bug, and we might not even agree
+ that it is a bug, we want to hear about problems you encounter. Often we
+ agree they are bugs and want to fix them.
+
+ To make it possible for us to fix a bug, please report it. In order to
+ do so effectively, it helps to know when and how to do it.
+
+ Before reporting a bug, it is a good idea to see if it is already known.
+ You can look at the @uref{http://debbugs.gnu.org/, GNU Bug Tracker}
+ and the @uref{http://lists.gnu.org/@/archive/@/html/@/bug-automake/,
+ bug-automake mailing list archives} for previous bug reports. We
+ previously used a
+ @uref{http://sourceware.org/@/cgi-bin/@/gnatsweb.pl?database=automake,
+ Gnats database} for bug tracking, so some bugs might have been reported
+ there already. Please do not use it for new bug reports, however.
+
+ If the bug is not already known, it should be reported. It is very
+ important to report bugs in a way that is useful and efficient. For
+ this, please familiarize yourself with
+ @uref{http://www.chiark.greenend.org.uk/@/~sgtatham/@/bugs.html, How to
+ Report Bugs Effectively} and
+ @uref{http://catb.org/@/~esr/@/faqs/@/smart-questions.html, How to Ask
+ Questions the Smart Way}. This helps you and developers to save time
+ which can then be spent on fixing more bugs and implementing more
+ features.
+
+ For a bug report, a feature request or other suggestions, please send
+ email to @email{@value{PACKAGE_BUGREPORT}}. This will then open a new
+ bug in the @uref{http://debbugs.gnu.org/@/automake, bug tracker}. Be
+ sure to include the versions of Autoconf and Automake that you use.
+ Ideally, post a minimal @file{Makefile.am} and @file{configure.ac} that
+ reproduces the problem you encounter. If you have encountered test
+ suite failures, please attach the @file{tests/test-suite.log} file.
+
+
@node History
@chapter History of Automake
* First Take on Dependencies:: Precomputed dependency tracking
* Dependencies As Side Effects:: Update at developer compile time
* Dependencies for the User:: Update at user compile time
- * Techniques for Dependencies:: Alternative approaches
+ * Techniques for Dependencies:: Alternative approaches
* Recommendations for Tool Writers:: What tool writers can do to help
* Future Directions for Dependencies:: Languages Automake does not know
@end menu
@printindex cp
- @page
- @contents
@bye
@c LocalWords: texinfo setfilename settitle setchapternewpage texi direntry
# @configure_input@
# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
- # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software
+ # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
# Foundation, Inc.
# This Makefile.in is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
@SET_MAKE@
-# Copyright (C) 2001, 2003, 2004, 2009 Free Software Foundation, Inc.
+# Copyright (C) 2001, 2003, 2004, 2009, 2010 Free Software Foundation,
+# Inc.
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
subdir = lib
DIST_COMMON = $(dist_pkgvdata_DATA) $(dist_script_DATA) \
$(srcdir)/Makefile.am $(srcdir)/Makefile.in COPYING INSTALL \
- ansi2knr.1 ansi2knr.c compile config.guess config.sub depcomp \
- elisp-comp install-sh mdate-sh missing mkinstalldirs \
+ ansi2knr.1 ansi2knr.c ar-lib compile config.guess config.sub \
+ depcomp elisp-comp install-sh mdate-sh missing mkinstalldirs \
py-compile texinfo.tex ylwrap
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/m4/amversion.m4 \
abs_top_srcdir = @abs_top_srcdir@
am_AUTOCONF = @am_AUTOCONF@
am_AUTOHEADER = @am_AUTOHEADER@
+ am_AUTOM4TE = @am_AUTOM4TE@
+ am_AUTORECONF = @am_AUTORECONF@
+ am_AUTOUPDATE = @am_AUTOUPDATE@
am__leading_dot = @am__leading_dot@
am__tar = @am__tar@
am__untar = @am__untar@
scriptdir = $(pkgvdatadir)
dist_script_DATA = config.guess config.sub install-sh mdate-sh missing \
mkinstalldirs elisp-comp ylwrap acinstall depcomp compile py-compile \
- symlink-tree
+ symlink-tree ar-lib
EXTRA_DIST = gnupload
all: all-recursive
installcheck: installcheck-recursive
install-strip:
- $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
- install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
- `test -z '$(STRIP)' || \
- echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
+ if test -z '$(STRIP)'; then \
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ install; \
+ else \
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
+ fi
mostlyclean-generic:
clean-generic:
#! /bin/sh
# depcomp - compile a program generating dependencies as side-effects
- scriptversion=2010-10-07.20; # UTC
+ scriptversion=2011-04-16.09; # UTC
- # Copyright (C) 1999, 2000, 2003, 2004, 2005, 2006, 2007, 2009, 2010
-# Copyright (C) 1999, 2000, 2003, 2004, 2005, 2006, 2007, 2009, 2011,
--# Free Software Foundation, Inc.
++# Copyright (C) 1999, 2000, 2003, 2004, 2005, 2006, 2007, 2009, 2010,
++# 2011 Free Software Foundation, Inc.
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# This is just like msvisualcpp but w/o cygpath translation.
# Just convert the backslash-escaped backslashes to single forward
# slashes to satisfy depend.m4
- cygpath_u="sed s,\\\\\\\\,/,g"
+ cygpath_u='sed s,\\\\,/,g'
depmode=msvisualcpp
fi
+if test "$depmode" = msvc7msys; then
+ # This is just like msvc7 but w/o cygpath translation.
+ # Just convert the backslash-escaped backslashes to single forward
+ # slashes to satisfy depend.m4
+ cygpath_u='sed s,\\\\,/,g'
+ depmode=msvc7
+fi
+
case "$depmode" in
gcc3)
## gcc 3 implements dependency tracking that does exactly what
' < "$tmpdepfile" |
## Some versions of gcc put a space before the `:'. On the theory
## that the space means something, we add a space to the output as
- ## well.
+ ## well. hp depmode also adds that space, but also prefixes the VPATH
+ ## to the object. Take care to not repeat it in the output.
## Some versions of the HPUX 10.20 sed can't process this invocation
## correctly. Breaking it into two sed invocations is a workaround.
- sed -e 's/^\\$//' -e '/^$/d' -e '/:$/d' | sed -e 's/$/ :/' >> "$depfile"
+ sed -e 's/^\\$//' -e '/^$/d' -e "s|.*$object$||" -e '/:$/d' \
+ | sed -e 's/$/ :/' >> "$depfile"
rm -f "$tmpdepfile"
;;
rm -f "$tmpdepfile"
;;
+msvc7)
+ if test "$libtool" = yes; then
+ showIncludes=-Wc,-showIncludes
+ else
+ showIncludes=-showIncludes
+ fi
+ "$@" $showIncludes > "$tmpdepfile"
+ stat=$?
+ grep -v '^Note: including file: ' "$tmpdepfile"
+ if test "$stat" = 0; then :
+ else
+ rm -f "$tmpdepfile"
+ exit $stat
+ fi
+ rm -f "$depfile"
+ echo "$object : \\" > "$depfile"
+ # The first sed program below extracts the file names and escapes
+ # backslashes for cygpath. The second sed program outputs the file
+ # name when reading, but also accumulates all include files in the
+ # hold buffer in order to output them again at the end. This only
+ # works with sed implementations that can handle large buffers.
+ sed < "$tmpdepfile" -n '
+/^Note: including file: *\(.*\)/ {
+ s//\1/
+ s/\\/\\\\/g
+ p
+}' | $cygpath_u | sort -u | sed -n '
+s/ /\\ /g
+s/\(.*\)/ \1 \\/p
+s/.\(.*\) \\/\1:/
+H
+$ {
+ s/.*/ /
+ G
+ p
+}' >> "$depfile"
+ rm -f "$tmpdepfile"
+ ;;
+
+msvc7msys)
+ # This case exists only to let depend.m4 do its work. It works by
+ # looking at the text of this script. This case will never be run,
+ # since it is checked for above.
+ exit 1
+ ;;
+
#nosideeffect)
# This comment above is used by automake to tell side-effect
# dependency tracking mechanisms from slower ones.
touch "$tmpdepfile"
${MAKEDEPEND-makedepend} -o"$obj_suffix" -f"$tmpdepfile" "$@"
rm -f "$depfile"
- cat < "$tmpdepfile" > "$depfile"
+ # makedepend may prepend the VPATH from the source file name to the object.
+ # No need to regex-escape $object, excess matching of '.' is harmless.
+ sed "s|^.*\($object *:\)|\1|" "$tmpdepfile" > "$depfile"
sed '1,2d' "$tmpdepfile" | tr ' ' '
' | \
## Some versions of the HPUX 10.20 sed can't process this invocation
## -*- Autoconf -*-
# Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2009,
- # 2010 Free Software Foundation, Inc.
+ # 2010, 2011 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
- # serial 11
+ # serial 12
# There are a few dirty hacks below to avoid letting `AC_PROG_CC' be
# written in clear, in which case automake, when reading aclocal.m4,
# instance it was reported that on HP-UX the gcc test will end up
# making a dummy file named `D' -- because `-MD' means `put the output
# in D'.
+ rm -rf conftest.dir
mkdir conftest.dir
# Copy depcomp to subdir because otherwise we won't find it if we're
# using a relative directory.
break
fi
;;
- msvisualcpp | msvcmsys)
+ msvc7 | msvc7msys | msvisualcpp | msvcmsys)
# This compiler won't grok `-c -o', but also, the minuso test has
# not run yet. These depmodes are late enough in the game, and
# so weak that their functioning should not be impacted.
## Process this file with automake to create Makefile.in
# Copyright (C) 1996, 1997, 1998, 1999, 2001, 2002, 2003, 2004, 2005,
- # 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+ # 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
- XFAIL_TESTS = \
- all.test \
- auxdir2.test \
- cond17.test \
- gcj6.test \
+ XFAIL_TESTS = \
+ all.test \
+ auxdir2.test \
+ cond17.test \
+ gcj6.test \
+ pr8365-remake-timing.test \
+ yacc-dist-nobuild-subdir.test \
+ vala-vpath.test \
txinfo5.test
include $(srcdir)/parallel-tests.am
MAINTAINERCLEANFILES = $(parallel_tests)
+ # Some testsuite-influential variables should be overridable from the
+ # test scripts, but not from the environment.
+ TESTS_ENVIRONMENT = \
+ test x"$$me" = x || unset me; \
+ test x"$$required" = x || unset required; \
+ test x"$$parallel_tests" = x || unset parallel_tests;
+
TESTS = \
+ self-check-env-sanitize.test \
+ self-check-report.test \
aclibobj.test \
aclocal.test \
aclocal3.test \
acsubst.test \
acsubst2.test \
all.test \
+ all2.test \
alloca.test \
alloca2.test \
alpha.test \
alpha2.test \
+ amhello-cflags.test \
+ amhello-cross-compile.test \
+ amhello-binpkg.test \
amassign.test \
ammissing.test \
amopt.test \
amsubst.test \
+ ansi2knr-deprecation.test \
ansi.test \
ansi2.test \
ansi3.test \
ansi8.test \
ansi9.test \
ansi10.test \
+ar-lib.test \
ar.test \
ar2.test \
asm.test \
asm2.test \
asm3.test \
+ autodist.test \
+ autodist-subdir.test \
+ autodist-acconfig.test \
+ autodist-acconfig-no-subdir.test \
+ autodist-aclocal-m4.test \
+ autodist-config-headers.test \
+ autodist-configure-no-subdir.test \
+ autodist-no-duplicate.test \
+ autodist-stamp-vti.test \
autohdr.test \
autohdr2.test \
autohdr3.test \
autohdr4.test \
+ autohdrdry.test \
automake.test \
auxdir.test \
auxdir2.test \
check9.test \
check10.test \
check11.test \
+ check-exported-srcdir.test \
+ check-tests-in-builddir.test \
+ check-tests_environment.test \
+ check-concurrency-bug9245.test \
+ tests-environment-backcompat.test \
checkall.test \
clean.test \
clean2.test \
comment9.test \
commen10.test \
commen11.test \
+ comments-in-var-def.test \
compile.test \
compile2.test \
+compile3.test \
+compile4.test \
+compile5.test \
+compile6.test \
compile_f90_c_cxx.test \
compile_f_c_cxx.test \
cond.test \
cond45.test \
condd.test \
condhook.test \
+ condhook2.test \
condinc.test \
condinc2.test \
condlib.test \
condman.test \
condman2.test \
+ condman3.test \
configure.test \
- conf2.test \
confdeps.test \
conff.test \
conff2.test \
confh.test \
confh4.test \
confh5.test \
- config.test \
+ confh6.test \
+ confh7.test \
+ confh8.test \
confincl.test \
conflnk.test \
conflnk2.test \
depcomp5.test \
depcomp6.test \
depcomp7.test \
+ depcomp8a.test \
+ depcomp8b.test \
+ depcomp9.test \
+ depcomp10.test \
depdist.test \
depend.test \
depend2.test \
depend5.test \
depend6.test \
destdir.test \
- dirforbid.test \
dirlist.test \
dirlist2.test \
discover.test \
+ dist-included-parent-dir.test \
distcleancheck.test \
distcom2.test \
distcom3.test \
distlinks.test \
distlinksbrk.test \
distname.test \
+ distcheck-configure-flags.test \
+ distcheck-configure-flags-am.test \
+ distcheck-configure-flags-subpkg.test \
+ distcheck-hook.test \
+ distcheck-hook2.test \
+ dmalloc.test \
+ doc-parsing-buglets-colneq-subst.test \
+ doc-parsing-buglets-tabs.test \
dollar.test \
dollarvar.test \
dollarvar2.test \
fort5.test \
fonly.test \
fortdep.test \
- fpinst2.test \
- fpinstall.test \
gcj.test \
gcj2.test \
gcj3.test \
gnits.test \
gnits2.test \
gnits3.test \
+ hdr-vars-defined-once.test \
header.test \
help.test \
+ help2.test \
+ help3.test \
+ help4.test \
+ help-depend.test \
+ help-depend2.test \
+ help-dmalloc.test \
+ help-init.test \
+ help-lispdir.test \
+ help-maintainer.test \
+ help-multilib.test \
+ help-python.test \
+ help-regex.test \
+ help-silent.test \
+ help-upc.test \
hfs.test \
hosts.test \
implicit.test \
- include.test \
- include2.test \
info.test \
init.test \
init2.test \
java.test \
java2.test \
java3.test \
+ java-check.test \
+ java-empty-classpath.test \
javaprim.test \
javasubst.test \
ldadd.test \
lex3.test \
lex4.test \
lex5.test \
+ lex-subobj-nodep.test \
lflags.test \
lflags2.test \
libexec.test \
lisp6.test \
lisp7.test \
lisp8.test \
+ lispdry.test \
listval.test \
location.test \
longline.test \
ltcond2.test \
ltconv.test \
ltdeps.test \
+ ltinit.test \
ltinstloc.test \
ltlibobjs.test \
ltlibsrc.test \
ltorder.test \
lzma.test \
+ m4-inclusion.test \
maintclean.test \
+ maintclean-vpath.test \
make.test \
makej.test \
makej2.test \
man3.test \
man4.test \
man5.test \
- mclean.test \
mdate.test \
mdate2.test \
mdate3.test \
mdate4.test \
mdate5.test \
+ mdate6.test \
missing.test \
missing2.test \
missing3.test \
parallel-tests8.test \
parallel-tests9.test \
parallel-tests10.test \
+ parallel-tests-harderror.test \
+ parallel-tests-unreadable-log.test \
+ parallel-tests-subdir.test \
+ parallel-tests-log-override-1.test \
+ parallel-tests-log-override-2.test \
+ parallel-tests-log-override-recheck.test \
+ parallel-tests-log-compiler-example.test \
parse.test \
percent.test \
percent2.test \
pluseq8.test \
pluseq9.test \
pluseq10.test \
+ pluseq11.test \
postproc.test \
ppf77.test \
pr2.test \
primary.test \
primary2.test \
primary3.test \
+ primary-prefix-invalid-couples.test \
+ primary-prefix-valid-couples.test \
+ primary-prefix-couples-force-valid.test \
+ primary-prefix-couples-documented-valid.test \
proginst.test \
python.test \
python2.test \
remake5.test \
remake6.test \
remake7.test \
+ remake-subdir-from-subdir.test \
+ remake-subdir-gnu.test \
+ remake-subdir.test \
+ remake-subdir2.test \
+ remake-subdir-long-time.test \
+ pr8365-remake-timing.test \
regex.test \
req.test \
reqd.test \
silent2.test \
silent3.test \
silent4.test \
- silent5.test \
silent6.test \
silent7.test \
silent9.test \
silentcxx.test \
silentf77.test \
silentf90.test \
- silentlex.test \
- silentyacc.test \
- sinclude.test \
+ silent-many-gcc.test \
+ silent-many-generic.test \
+ silent-lex-gcc.test \
+ silent-lex-generic.test \
+ silent-yacc-gcc.test \
+ silent-yacc-generic.test \
+ silent-configsite.test \
srcsub.test \
srcsub2.test \
space.test \
specflg8.test \
specflg9.test \
specflg10.test \
+ specflg-dummy.test \
spell.test \
spell2.test \
spell3.test \
stdlib.test \
stdlib2.test \
strip.test \
+ strip2.test \
+ strip3.test \
subdir.test \
subdir2.test \
subdir3.test \
subobj8.test \
subobj9.test \
subobj10.test \
+ subobj11a.test \
+ subobj11b.test \
+ subobj11c.test \
subobjname.test \
subpkg.test \
subpkg2.test \
txinfo3.test \
txinfo4.test \
txinfo5.test \
+ txinfo5b.test \
txinfo6.test \
txinfo7.test \
txinfo8.test \
vala3.test \
vala4.test \
vala5.test \
+ vala-vpath.test \
vars.test \
vars3.test \
vartar.test \
vpath.test \
vtexi.test \
vtexi2.test \
+ vtexi3.test \
+ vtexi4.test \
warnopts.test \
werror.test \
werror2.test \
yacc6.test \
yacc7.test \
yacc8.test \
+ yaccdry.test \
yaccpp.test \
yaccvpath.test \
+ yacc-dist-nobuild-subdir.test \
yflags.test \
yflags2.test \
$(parallel_tests)
if test "$$#,$$1" = "1,*.dir"; then \
: there is no test directory to clean; \
else \
- find "$$@" -type d '!' -perm -200 -exec chmod u+w {} ';'; \
+ find "$$@" -type d ! -perm -700 -exec chmod u+rwx {} ';'; \
rm -rf "$$@"; \
fi;
# @configure_input@
# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
- # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software
+ # 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
# Foundation, Inc.
# This Makefile.in is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
@SET_MAKE@
# Copyright (C) 1996, 1997, 1998, 1999, 2001, 2002, 2003, 2004, 2005,
- # 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+ # 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
am__rst_title = sed 's/.*/ & /;h;s/./=/g;p;x;p;g;p;s/.*//'
am__rst_section = sed 'p;s/./=/g;p;g'
# Put stdin (possibly several lines separated by ". ") in a box.
- am__text_box = $(AWK) '{ \
- n = split($$0, lines, "\\. "); max = 0; \
- for (i = 1; i <= n; ++i) \
- if (max < length(lines[i])) \
- max = length(lines[i]); \
- for (i = 0; i < max; ++i) line = line "="; \
- print line; \
- for (i = 1; i <= n; ++i) if (lines[i]) print lines[i];\
- print line; \
+ # Prefix each line by 'col' and terminate each with 'std', for coloring.
+ # Multi line coloring is problematic with "less -R", so we really need
+ # to color each line individually.
+ am__text_box = $(AWK) '{ \
+ n = split($$0, lines, "\\. "); max = 0; \
+ for (i = 1; i <= n; ++i) \
+ if (max < length(lines[i])) \
+ max = length(lines[i]); \
+ for (i = 0; i < max; ++i) \
+ line = line "="; \
+ print col line std; \
+ for (i = 1; i <= n; ++i) \
+ if (lines[i]) \
+ print col lines[i] std; \
+ print col line std; \
}'
# Solaris 10 'make', and several other traditional 'make' implementations,
- # pass "-e" to $(SHELL). This contradicts POSIX. Work around the problem
+ # pass "-e" to $(SHELL), and POSIX 2008 even requires this. Work around it
# by disabling -e (using the XSI extension "set +e") if it's set.
am__sh_e_setup = case $$- in *e*) set +e;; esac
# To be inserted before the command running the test. Creates the
else dir="$(srcdir)/"; fi; \
tst=$$dir$$f; log='$@'; __SAVED_TERM=$$TERM; \
$(TESTS_ENVIRONMENT)
+ # To be appended to the command running the test. Handle the stdout
+ # and stderr redirection, and catch the exit status.
+ am__check_post = \
+ >$@-t 2>&1; \
+ estatus=$$?; \
+ if test -n '$(DISABLE_HARD_ERRORS)' \
+ && test $$estatus -eq 99; then \
+ estatus=1; \
+ fi; \
+ TERM=$$__SAVED_TERM; export TERM; \
+ $(am__tty_colors); \
+ xfailed=PASS; \
+ case " $(XFAIL_TESTS) " in \
+ *[\ \ ]$$f[\ \ ]* | *[\ \ ]$$dir$$f[\ \ ]*) \
+ xfailed=XFAIL;; \
+ esac; \
+ case $$estatus.$$xfailed in \
+ 0.XFAIL) col=$$red; res=XPASS;; \
+ 0.*) col=$$grn; res=PASS ;; \
+ 77.*) col=$$blu; res=SKIP ;; \
+ 99.*) col=$$red; res=FAIL ;; \
+ *.XFAIL) col=$$lgn; res=XFAIL;; \
+ *.*) col=$$red; res=FAIL ;; \
+ esac; \
+ echo "$${col}$$res$${std}: $$f"; \
+ echo "$$res: $$f (exit: $$estatus)" | \
+ $(am__rst_section) >$@; \
+ cat $@-t >>$@; \
+ rm -f $@-t
RECHECK_LOGS = $(TEST_LOGS)
AM_RECURSIVE_TARGETS = check check-html recheck recheck-html
TEST_SUITE_LOG = test-suite.log
abs_top_srcdir = @abs_top_srcdir@
am_AUTOCONF = @am_AUTOCONF@
am_AUTOHEADER = @am_AUTOHEADER@
+ am_AUTOM4TE = @am_AUTOM4TE@
+ am_AUTORECONF = @am_AUTORECONF@
+ am_AUTOUPDATE = @am_AUTOUPDATE@
am__leading_dot = @am__leading_dot@
am__tar = @am__tar@
am__untar = @am__untar@
top_builddir = @top_builddir@
top_srcdir = @top_srcdir@
XFAIL_TESTS = \
- all.test \
- auxdir2.test \
- cond17.test \
- gcj6.test \
+ all.test \
+ auxdir2.test \
+ cond17.test \
+ gcj6.test \
+ pr8365-remake-timing.test \
+ yacc-dist-nobuild-subdir.test \
+ vala-vpath.test \
txinfo5.test
parallel_tests = \
+ check-concurrency-bug9245-p.test \
+ check-exported-srcdir-p.test \
+ check-tests-in-builddir-p.test \
+ check-tests_environment-p.test \
check-p.test \
check10-p.test \
check11-p.test \
dejagnu-p.test \
exeext4-p.test \
maken3-p.test \
- maken4-p.test \
- pr401-p.test \
- pr401b-p.test \
- pr401c-p.test
+ maken4-p.test
MAINTAINERCLEANFILES = $(parallel_tests)
+
+ # Some testsuite-influential variables should be overridable from the
+ # test scripts, but not from the environment.
+ TESTS_ENVIRONMENT = \
+ test x"$$me" = x || unset me; \
+ test x"$$required" = x || unset required; \
+ test x"$$parallel_tests" = x || unset parallel_tests;
+
TESTS = \
+ self-check-env-sanitize.test \
+ self-check-report.test \
aclibobj.test \
aclocal.test \
aclocal3.test \
acsubst.test \
acsubst2.test \
all.test \
+ all2.test \
alloca.test \
alloca2.test \
alpha.test \
alpha2.test \
+ amhello-cflags.test \
+ amhello-cross-compile.test \
+ amhello-binpkg.test \
amassign.test \
ammissing.test \
amopt.test \
amsubst.test \
+ ansi2knr-deprecation.test \
ansi.test \
ansi2.test \
ansi3.test \
ansi8.test \
ansi9.test \
ansi10.test \
+ar-lib.test \
ar.test \
ar2.test \
asm.test \
asm2.test \
asm3.test \
+ autodist.test \
+ autodist-subdir.test \
+ autodist-acconfig.test \
+ autodist-acconfig-no-subdir.test \
+ autodist-aclocal-m4.test \
+ autodist-config-headers.test \
+ autodist-configure-no-subdir.test \
+ autodist-no-duplicate.test \
+ autodist-stamp-vti.test \
autohdr.test \
autohdr2.test \
autohdr3.test \
autohdr4.test \
+ autohdrdry.test \
automake.test \
auxdir.test \
auxdir2.test \
check9.test \
check10.test \
check11.test \
+ check-exported-srcdir.test \
+ check-tests-in-builddir.test \
+ check-tests_environment.test \
+ check-concurrency-bug9245.test \
+ tests-environment-backcompat.test \
checkall.test \
clean.test \
clean2.test \
comment9.test \
commen10.test \
commen11.test \
+ comments-in-var-def.test \
compile.test \
compile2.test \
+compile3.test \
+compile4.test \
+compile5.test \
+compile6.test \
compile_f90_c_cxx.test \
compile_f_c_cxx.test \
cond.test \
cond45.test \
condd.test \
condhook.test \
+ condhook2.test \
condinc.test \
condinc2.test \
condlib.test \
condman.test \
condman2.test \
+ condman3.test \
configure.test \
- conf2.test \
confdeps.test \
conff.test \
conff2.test \
confh.test \
confh4.test \
confh5.test \
- config.test \
+ confh6.test \
+ confh7.test \
+ confh8.test \
confincl.test \
conflnk.test \
conflnk2.test \
depcomp5.test \
depcomp6.test \
depcomp7.test \
+ depcomp8a.test \
+ depcomp8b.test \
+ depcomp9.test \
+ depcomp10.test \
depdist.test \
depend.test \
depend2.test \
depend5.test \
depend6.test \
destdir.test \
- dirforbid.test \
dirlist.test \
dirlist2.test \
discover.test \
+ dist-included-parent-dir.test \
distcleancheck.test \
distcom2.test \
distcom3.test \
distlinks.test \
distlinksbrk.test \
distname.test \
+ distcheck-configure-flags.test \
+ distcheck-configure-flags-am.test \
+ distcheck-configure-flags-subpkg.test \
+ distcheck-hook.test \
+ distcheck-hook2.test \
+ dmalloc.test \
+ doc-parsing-buglets-colneq-subst.test \
+ doc-parsing-buglets-tabs.test \
dollar.test \
dollarvar.test \
dollarvar2.test \
fort5.test \
fonly.test \
fortdep.test \
- fpinst2.test \
- fpinstall.test \
gcj.test \
gcj2.test \
gcj3.test \
gnits.test \
gnits2.test \
gnits3.test \
+ hdr-vars-defined-once.test \
header.test \
help.test \
+ help2.test \
+ help3.test \
+ help4.test \
+ help-depend.test \
+ help-depend2.test \
+ help-dmalloc.test \
+ help-init.test \
+ help-lispdir.test \
+ help-maintainer.test \
+ help-multilib.test \
+ help-python.test \
+ help-regex.test \
+ help-silent.test \
+ help-upc.test \
hfs.test \
hosts.test \
implicit.test \
- include.test \
- include2.test \
info.test \
init.test \
init2.test \
java.test \
java2.test \
java3.test \
+ java-check.test \
+ java-empty-classpath.test \
javaprim.test \
javasubst.test \
ldadd.test \
lex3.test \
lex4.test \
lex5.test \
+ lex-subobj-nodep.test \
lflags.test \
lflags2.test \
libexec.test \
lisp6.test \
lisp7.test \
lisp8.test \
+ lispdry.test \
listval.test \
location.test \
longline.test \
ltcond2.test \
ltconv.test \
ltdeps.test \
+ ltinit.test \
ltinstloc.test \
ltlibobjs.test \
ltlibsrc.test \
ltorder.test \
lzma.test \
+ m4-inclusion.test \
maintclean.test \
+ maintclean-vpath.test \
make.test \
makej.test \
makej2.test \
man3.test \
man4.test \
man5.test \
- mclean.test \
mdate.test \
mdate2.test \
mdate3.test \
mdate4.test \
mdate5.test \
+ mdate6.test \
missing.test \
missing2.test \
missing3.test \
parallel-tests8.test \
parallel-tests9.test \
parallel-tests10.test \
+ parallel-tests-harderror.test \
+ parallel-tests-unreadable-log.test \
+ parallel-tests-subdir.test \
+ parallel-tests-log-override-1.test \
+ parallel-tests-log-override-2.test \
+ parallel-tests-log-override-recheck.test \
+ parallel-tests-log-compiler-example.test \
parse.test \
percent.test \
percent2.test \
pluseq8.test \
pluseq9.test \
pluseq10.test \
+ pluseq11.test \
postproc.test \
ppf77.test \
pr2.test \
primary.test \
primary2.test \
primary3.test \
+ primary-prefix-invalid-couples.test \
+ primary-prefix-valid-couples.test \
+ primary-prefix-couples-force-valid.test \
+ primary-prefix-couples-documented-valid.test \
proginst.test \
python.test \
python2.test \
remake5.test \
remake6.test \
remake7.test \
+ remake-subdir-from-subdir.test \
+ remake-subdir-gnu.test \
+ remake-subdir.test \
+ remake-subdir2.test \
+ remake-subdir-long-time.test \
+ pr8365-remake-timing.test \
regex.test \
req.test \
reqd.test \
silent2.test \
silent3.test \
silent4.test \
- silent5.test \
silent6.test \
silent7.test \
silent9.test \
silentcxx.test \
silentf77.test \
silentf90.test \
- silentlex.test \
- silentyacc.test \
- sinclude.test \
+ silent-many-gcc.test \
+ silent-many-generic.test \
+ silent-lex-gcc.test \
+ silent-lex-generic.test \
+ silent-yacc-gcc.test \
+ silent-yacc-generic.test \
+ silent-configsite.test \
srcsub.test \
srcsub2.test \
space.test \
specflg8.test \
specflg9.test \
specflg10.test \
+ specflg-dummy.test \
spell.test \
spell2.test \
spell3.test \
stdlib.test \
stdlib2.test \
strip.test \
+ strip2.test \
+ strip3.test \
subdir.test \
subdir2.test \
subdir3.test \
subobj8.test \
subobj9.test \
subobj10.test \
+ subobj11a.test \
+ subobj11b.test \
+ subobj11c.test \
subobjname.test \
subpkg.test \
subpkg2.test \
txinfo3.test \
txinfo4.test \
txinfo5.test \
+ txinfo5b.test \
txinfo6.test \
txinfo7.test \
txinfo8.test \
vala3.test \
vala4.test \
vala5.test \
+ vala-vpath.test \
vars.test \
vars3.test \
vartar.test \
vpath.test \
vtexi.test \
vtexi2.test \
+ vtexi3.test \
+ vtexi4.test \
warnopts.test \
werror.test \
werror2.test \
yacc6.test \
yacc7.test \
yacc8.test \
+ yaccdry.test \
yaccpp.test \
yaccvpath.test \
+ yacc-dist-nobuild-subdir.test \
yflags.test \
yflags2.test \
$(parallel_tests)
CTAGS:
- # To be appended to the command running the test. Handle the stdout
- # and stderr redirection, and catch the exit status.
- am__check_post = \
- >$@-t 2>&1; \
- estatus=$$?; \
- if test -n '$(DISABLE_HARD_ERRORS)' \
- && test $$estatus -eq 99; then \
- estatus=1; \
- fi; \
- TERM=$$__SAVED_TERM; export TERM; \
- $(am__tty_colors); \
- xfailed=PASS; \
- case " $(XFAIL_TESTS) " in \
- *[\ \ ]$$f[\ \ ]* | *[\ \ ]$$dir$$f[\ \ ]*) \
- xfailed=XFAIL;; \
- esac; \
- case $$estatus:$$xfailed in \
- 0:XFAIL) col=$$red; res=XPASS;; \
- 0:*) col=$$grn; res=PASS ;; \
- 77:*) col=$$blu; res=SKIP ;; \
- 99:*) col=$$red; res=FAIL ;; \
- *:XFAIL) col=$$lgn; res=XFAIL;; \
- *:*) col=$$red; res=FAIL ;; \
- esac; \
- echo "$${col}$$res$${std}: $$f"; \
- echo "$$res: $$f (exit: $$estatus)" | \
- $(am__rst_section) >$@; \
- cat $@-t >>$@; \
- rm -f $@-t
-
$(TEST_SUITE_LOG): $(TEST_LOGS)
@$(am__sh_e_setup); \
list='$(TEST_LOGS)'; \
results=`for f in $$list; do \
- read line < $$f && echo "$$line" || echo FAIL; \
+ test -r $$f && read line < $$f && echo "$$line" \
+ || echo FAIL; \
done`; \
all=`echo "$$results" | sed '/^$$/d' | wc -l | sed -e 's/^[ ]*//'`; \
fail=`echo "$$results" | grep -c '^FAIL'`; \
echo ".. contents:: :depth: 2"; \
echo; \
for f in $$list; do \
- read line < $$f; \
+ test -r $$f && read line < $$f || line=; \
case $$line in \
PASS:*|XFAIL:*);; \
*) echo; cat $$f;; \
test x"$$VERBOSE" = x || $$exit || cat $(TEST_SUITE_LOG); \
$(am__tty_colors); \
if $$exit; then \
- echo $(ECHO_N) "$$grn$(ECHO_C)"; \
+ col="$$grn"; \
else \
- echo $(ECHO_N) "$$red$(ECHO_C)"; \
+ col="$$red"; \
fi; \
- echo "$$msg" | $(am__text_box); \
- echo $(ECHO_N) "$$std$(ECHO_C)"; \
- $$exit
+ echo "$$msg" | $(am__text_box) "col=$$col" "std=$$std"; \
+ $$exit || exit 1
# Run all the tests.
check-TESTS:
list='$(TEST_LOGS)'; \
list=`for f in $$list; do \
test -f $$f || continue; \
- if read line < $$f; then \
+ if test -r $$f && read line < $$f; then \
case $$line in FAIL*|XPASS*) echo $$f;; esac; \
else echo $$f; fi; \
done | tr '\012\015' ' '`; \
+ list=`echo "$$list" | sed 's/ *$$//'`; \
$(MAKE) $(AM_MAKEFLAGS) $$target AM_MAKEFLAGS='$(AM_MAKEFLAGS) TEST_LOGS="'"$$list"'"'
.test.log:
@p='$<'; $(am__check_pre) $(TEST_LOG_COMPILE) "$$tst" $(am__check_post)
installcheck: installcheck-am
install-strip:
- $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
- install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
- `test -z '$(STRIP)' || \
- echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
+ if test -z '$(STRIP)'; then \
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ install; \
+ else \
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
+ fi
mostlyclean-generic:
-test -z "$(TEST_LOGS)" || rm -f $(TEST_LOGS)
-test -z "$(TEST_LOGS_TMP)" || rm -f $(TEST_LOGS_TMP)
if test "$$#,$$1" = "1,*.dir"; then \
: there is no test directory to clean; \
else \
- find "$$@" -type d '!' -perm -200 -exec chmod u+w {} ';'; \
+ find "$$@" -type d ! -perm -700 -exec chmod u+rwx {} ';'; \
rm -rf "$$@"; \
fi;
# @configure_input@
#
# Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
- # 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
+ # 2005, 2006, 2007, 2008, 2009, 2011 Free Software Foundation, Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
case `(set -o) 2>/dev/null` in *posix*) set -o posix;; esac
fi
+ # A single whitespace character.
+ sp=' '
+ # A tabulation character.
+ tab=' '
+ # A newline character.
+ nl='
+ '
+
+ # As autoconf-generated configure scripts do, ensure that IFS
+ # is defined initially, so that saving and restoring $IFS works.
+ IFS=$sp$tab$nl
+
# Ensure we are running from the right directory.
test -f ./defs || {
echo "defs: not found in current directory" 1>&2
exit 1
}
- me=`echo "$0" | sed -e 's,.*[\\/],,;s/\.test$//'`
+ # The name of the current test (without the `.test' suffix).
+ # Test scripts can override it if they need to (but this should
+ # be done carefully, and *before* including ./defs).
+ if test -z "$me"; then
+ me=`echo "$0" | sed -e 's,.*[\\/],,;s/\.test$//'`
+ elif env | grep '^me=' >/dev/null; then
+ echo "$0: variable \`me' is set in the environment: this is unsafe" >&2
+ exit 99
+ fi
+
+ # Check that the environment is properly sanitized.
+ for var in required parallel_tests; do
+ if env | grep "^$var=" >/dev/null; then
+ echo "$me: variable \`$var' is set in the environment:" \
+ "this is unsafe" >&2
+ exit 99
+ fi
+ done
+ unset var
+
+ # This might be used in testcases checking distribution-related features.
+ # Test scripts are free to override this if they need to.
+ distdir=$me-1.0
+
+ APIVERSION='@APIVERSION@'
+ PATH_SEPARATOR='@PATH_SEPARATOR@'
# Make sure we override the user shell.
SHELL='@SHELL@'
test -z "$PERL" && PERL='@PERL@'
test -z "$MAKE" && MAKE=make
test -z "$AUTOCONF" && AUTOCONF="@am_AUTOCONF@"
+ test -z "$AUTOM4TE" && AUTOM4TE="@am_AUTOM4TE@"
+ test -z "$AUTORECONF" && AUTORECONF="@am_AUTORECONF@"
test -z "$AUTOHEADER" && AUTOHEADER="@am_AUTOHEADER@"
- test -z "$AUTOUPDATE" && AUTOUPDATE=autoupdate
+ test -z "$AUTOUPDATE" && AUTOUPDATE="@am_AUTOUPDATE@"
test -z "$MISSING" && MISSING=`pwd`/../lib/missing
# Use -Werror because this also turns some Perl warnings into error.
# (Tests for which this is inappropriate should use -Wno-error.)
- test -z "$ACLOCAL" && ACLOCAL="aclocal-@APIVERSION@ -Werror"
- # Extra flags to pass to aclocal before all other flags added by this script.
- ACLOCAL_TESTSUITE_FLAGS=
- export ACLOCAL_TESTSUITE_FLAGS
+ test -z "$ACLOCAL" && ACLOCAL="aclocal-$APIVERSION -Werror"
# See how Automake should be run. We put --foreign as the default
# strictness to avoid having to create lots and lots of files. A test
# -Werror by default. Tests for which this is inappropriate
# (e.g. when testing that a warning is enabled by a specific switch)
# should use -Wnone or/and -Wno-error
- test -z "$AUTOMAKE" && AUTOMAKE="automake-@APIVERSION@ --foreign -Werror -Wall"
+ test -z "$AUTOMAKE" && AUTOMAKE="automake-$APIVERSION --foreign -Werror -Wall"
- PATH="`pwd`@PATH_SEPARATOR@$PATH"
+ PATH="`pwd`$PATH_SEPARATOR$PATH"
echo "$PATH"
# Some shells forget to export modified environment variables.
# (See note about `export' in the Autoconf manual.)
export PATH
+ # We use a trap below for cleanup. This requires us to go through
+ # hoops to get the right exit status transported through the signal.
+ # So use `Exit STATUS' instead of `exit STATUS' inside of the tests.
+ # Turn off errexit here so that we don't trip the bug with OSF1/Tru64
+ # sh inside this function.
+ Exit ()
+ {
+ set +e
+ (exit $1)
+ exit $1
+ }
+
+ # Print warnings (e.g., about skipped and failed tests) to this file
+ # number. Override by putting, say:
+ # stderr_fileno_=9; export stderr_fileno_; exec 9>&2;
+ # in the definition of AM_TESTS_ENVIRONMENT.
+ # This is useful when using automake's parallel tests mode, to print the
+ # reason for skip/failure to console, rather than to the *.log files.
+ : ${stderr_fileno_=2}
+
+ # Copied from Gnulib's `tests/init.sh'.
+ warn_ () { echo "$@" 1>&$stderr_fileno_; }
+ fail_ () { warn_ "$me: failed test: $@"; Exit 1; }
+ skip_ () { warn_ "$me: skipped test: $@"; Exit 77; }
+ fatal_ () { warn_ "$me: hard error: $@"; Exit 99; }
+ framework_failure_ () { warn_ "$me: set-up failure: $@"; Exit 99; }
+
+ # cross_compiling
+ # ---------------
+ # Tell whether we are cross-compiling. This is especially useful to skip
+ # tests (or portions of them) that requires a native compiler.
+ cross_compiling ()
+ {
+ test x"$host_alias" != x
+ }
+
+ # So that we can force the use of correct gcc, g++ etc., consistently
+ # with cross-compilation settings.
+ if cross_compiling; then
+ am__tool_prefix="$host_alias-"
+ else
+ am__tool_prefix=
+ fi
+
for tool in : $required
do
# Check that each required tool is present.
case $tool in
:) ;;
- bison)
+ bison|yacc)
# Since bison is required, we pick YACC for ./configure.
YACC='bison -y'
export YACC
echo "$me: running bison --version"
( bison --version ) || exit 77
;;
+ flex|lex)
+ # Since flex is required, we pick LEX for ./configure.
+ LEX=flex
+ export LEX
+ echo "$me: running flex --version"
+ flex --version || exit 77
+ ;;
+ cc|c++|fortran|fortran77)
+ echo "$me: dummy requirement '$tool', no check done"
+ ;;
bzip2)
# Do not use --version, bzip2 still tries to compress stdin.
echo "$me: running bzip2 --help"
( bzip2 --help ) || exit 77
;;
+ cl)
+ CC=cl
+ export CC
+ echo "$me: running $CC -?"
+ ( $CC -? ) || exit 77
+ ;;
etags)
# Exuberant Ctags will create a TAGS file even
# when asked for --help or --version. (Emacs's etags
# always use it. This is important only when the user
# has defined CC in his environment, otherwise ./configure will
# prefer gcc to other compilers.
- CC=gcc
+ CC=${am__tool_prefix}gcc
export CC
echo "$me: running $CC --version"
( $CC --version ) || exit 77
;;
gcj)
- GCJ=gcj
+ GCJ=${am__tool_prefix}gcj
export GCJ
echo "$me: running $GCJ --version"
( $GCJ --version ) || exit 77
( $GCJ -v ) || exit 77
;;
g++)
- CXX=g++
+ CXX=${am__tool_prefix}g++
export CXX
echo "$me: running $CXX --version"
( $CXX --version ) || exit 77
;;
+ gfortran)
+ FC=${am__tool_prefix}gfortran
+ export FC
+ echo "$me: running $FC --version"
+ $FC --version || skip_ "GNU Fortran compiler not available"
+ echo "$me: running $FC -v"
+ $FC -v || skip_ "botched installation for GNU Fortran compiler"
+ case " $required " in
+ *\ g77\ *) ;;
+ *) F77=$FC; export F77;;
+ esac
+ ;;
+ g77)
+ F77=${am__tool_prefix}g77
+ export F77
+ echo "$me: running $F77 --version"
+ $F77 --version || skip_ "GNU Fortran 77 compiler not available"
+ echo "$me: running $F77 -v"
+ $F77 -v || skip_ "botched installation for GNU Fortran 77 compiler"
+ case " $required " in
+ *\ gfortran\ *) ;;
+ *) FC=$F77; export FC;;
+ esac
+ ;;
icc)
CC=icc
export CC
echo "$me: running $CC -V -help"
( $CC -V -help ) || exit 77
;;
+ javac)
+ # The Java compiler from JDK 1.5 (and presumably earlier versions)
+ # cannot handle the `-version' option by itself: it bails out
+ # telling that source files are missing. Adding also the `-help'
+ # option seems to solve the problem.
+ echo "$me: running javac -version -help"
+ javac -version -help || exit 77
+ ;;
makedepend)
echo "$me: running makedepend -f-"
( makedepend -f- ) || exit 77
rm -f $priv_check_temp
test $overwrite_status = 0 && exit 77
;;
+ native)
+ cross_compiling && skip_ "doesn't work in cross-compile mode"
+ ;;
python)
# Python doesn't support --version, it has -V
echo "$me: running python -V"
echo "$me: running texi2dvi -o /dev/null --version"
( texi2dvi -o /dev/null --version ) || exit 77
;;
+ xsi-shell)
+ # Try some XSI features.
+ echo "$me: trying some XSI constructs"
+ ( _am_dummy="a/b/c"
+ test "${_am_dummy##*/},${_am_dummy%/*},${_am_dummy#??}"${_am_dummy%"$_am_dummy"}, \
+ = c,a/b,b/c, \
+ && eval 'test $(( 1 + 1 )) -eq 2 \
+ && test "${#_am_dummy}" -eq 5' ) || exit 77
+ ;;
# Generic case: the tool must support --version.
*)
echo "$me: running $tool --version"
;;
esac
- # We use a trap below for cleanup. This requires us to go through
- # hoops to get the right exit status transported through the signal.
- # So use `Exit STATUS' instead of `exit STATUS' inside of the tests.
- # Turn off errexit here so that we don't trip the bug with OSF1/Tru64
- # sh inside this function.
- Exit ()
- {
- set +e
- (exit $1)
- exit $1
- }
-
curdir=`pwd`
testSubDir=$me.dir
test ! -d $testSubDir || {
- find $testSubDir -type d ! -perm -200 -exec chmod u+w {} ";"
+ find $testSubDir -type d ! -perm -700 -exec chmod u+rwx {} ";"
rm -rf $testSubDir
}
mkdir $testSubDir
cd "$curdir"
case $exit_status,$keep_testdirs in
0,)
- find $testSubDir -type d ! -perm -200 -exec chmod u+w {} ";"
+ find $testSubDir -type d ! -perm -700 -exec chmod u+rwx {} ";"
rm -rf $testSubDir
;;
esac
unset prefix exec_prefix bindir datarootdir datadir docdir dvidir
unset htmldir includedir infodir libdir libexecdir localedir mandir
unset oldincludedir pdfdir psdir sbindir sharedstatedir sysconfdir
+ # Unset variables that might change the "make distcheck" behaviour.
+ unset DISTCHECK_CONFIGURE_FLAGS AM_DISTCHECK_CONFIGURE_FLAGS
# Also unset variables that control our test driver. While not
# conceptually independent, they cause some changed semantics we
# need to control (and test for) in some of the tests to ensure
# backward-compatible behavior.
+ unset TESTS_ENVIRONMENT AM_TESTS_ENVIRONMENT
unset DISABLE_HARD_ERRORS
+ unset AM_COLOR_TESTS
unset TESTS
unset TEST_LOG_COMPILER
unset TEST_LOGS
test -z "$is_newest_files"
}
+ # using_gmake
+ # -----------
+ # Return success if $MAKE is GNU make, return failure otherwise.
+ using_gmake ()
+ {
+ # Use --version AND -v, because SGI Make doesn't fail on --version.
+ # Also grep for GNU because newer versions of FreeBSD make do
+ # not complain about `--version' (they seem to silently ignore it).
+ $MAKE --version -v | grep GNU
+ }
# AUTOMAKE_run status [options...]
# --------------------------------
AUTOMAKE_run 1 ${1+"$@"}
}
+ commented_sed_unindent_prog='
+ /^$/b # Nothing to do for empty lines.
+ x # Get x<indent> into pattern space.
+ /^$/{ # No prior x<indent>, go prepare it.
+ g # Copy this 1st non-blank line into pattern space.
+ s/^\(['"$tab"' ]*\).*/x\1/ # Prepare x<indent> in pattern space.
+ } # Now: x<indent> in pattern and <line> in hold.
+ G # Build x<indent>\n<line> in pattern space, and
+ h # duplicate it into hold space.
+ s/\n.*$// # Restore x<indent> in pattern space, and
+ x # exchange with the above duplicate in hold space.
+ s/^x\(.*\)\n\1// # Remove leading <indent> from <line>.
+ s/^x.*\n// # Restore <line> when there is no leading <indent>.
+ '
+
+ # unindent [input files...]
+ # -------------------------
+ # Remove the "proper" amount of leading whitespace from the given files,
+ # and output the result on stdout. That amount is determined by looking
+ # at the leading whitespace of the first non-blank line in the input
+ # files. If no input file is specified, standard input is implied.
+ unindent ()
+ {
+ if test x"$sed_unindent_prog" = x; then
+ sed_unindent_prog=`printf '%s\n' "$commented_sed_unindent_prog" | sed -e "s/ *# .*//"`
+ fi
+ sed "$sed_unindent_prog" ${1+"$@"}
+ }
+ sed_unindent_prog="" # Avoid interferences from the environment.
+
# Turn on shell traces.
set -x
projects / platform / upstream / automake.git / commitdiff