kc3-lang/automake/doc

Branch :

Log

Author Commit Date CI Message
15400bca 2011-06-30 14:55:43 parallel-tests: new recognized test result 'ERROR' * lib/am/check.am ($(TEST_SUITE_LOG)): Recognize a new test result `ERROR'. Use it when encountering unreadable test logs (previously a simple `FAIL' was used in this situations). * lib/test-driver: Set the global test result to `ERROR' when the test exit status is 99. When doing colorized output, color `ERROR' results in magenta. * doc/automake.texi (Log files generation and test results recording): Update by also listing `ERROR' among the list of valid `:test-results:' arguments. * NEWS: Update. * tests/trivial-test-driver: Update. * tests/parallel-tests.test: Likewise. * tests/parallel-tests-harderror.test: Likewise. * tests/parallel-tests-no-spurious-summary.test: Likewise. * tests/test-driver-global-log.test: Likewise. * tests/test-driver-recheck.test: Likewise. * tests/test-driver-custom-multitest-recheck.test: Likewise. * tests/test-driver-custom-multitest-recheck2.test: Likewise. * tests/test-driver-custom-multitest.test: Likewise. * tests/test-driver-custom-no-html.test: Likewise. * tests/test-driver-end-test-results.test: Likewise. * tests/color.test: Likewise. Also, make stricter, and also test from VPATH. * tests/color2.test: Likewise, and improve syncing with color.test. * tests/parallel-tests-exit-statuses.test: New test. * tests/parallel-tests-console-output.test: Likewise. * tests/Makefile.am (TESTS): Update.
61b2bb0d 2011-06-29 16:02:52 parallel-tests: make parsing of test results safer The new code for parsing the testsuite-generated `.log' files, as introduced in commit `v1.11-872-gc96b881', considers each `:test-result:' field anywhere in a `.log' file as a declaration of a test result, and accounts for it as such in the testsuite summary. Unfortunately this could easily cause spurious test failures being reported in the testsuite summary. This happened in practice with the Automake's own testsuite; for example: $ make check TESTS='check12-p.test'; echo exit: $? ... PASS: check12-p.test ===================================== 4 of 5 tests failed See tests/test-suite.log Please report to bug-automake@gnu.org ===================================== make[2]: *** [test-suite.log] Error 1 make: *** [check-am] Error 2 exit: 2 This change introduces a new special `:test-result:' "END", that, when seen, prevents the rest of the log file from being parsed. For more information, refer to the thread: <http://lists.gnu.org/archive/html/automake-patches/2011-06/msg00199.html> * lib/am/check.am ($(TEST_SUITE_LOG)): Stop the parsing of a log file as soon as the special ":test-result:END" directive is seen. Related changes and enhancements. * lib/test-driver: Protect the rest of the log after the result lined with a ":test-result:END" directive. * tests/parallel-tests-no-spurious-summary.test: New test. * tests/test-driver-end-test-results.test: Likewise. * tests/Makefile.am (TESTS): Update.
14027413 2011-06-22 21:59:34 docs: document custom test drivers and protocols * doc/automake.texi (Simple Tests): Note that the TESTS_ENVIRONMENT use suggested here is not portable to 'parallel-tests'. (Simple Tests using parallel-tests): Document new restrictions on the uses of TESTS_ENVIRONMENT and AM_TESTS_ENVIRONMENT. (Custom Test Drivers): New section and node. (Overview of Custom Test Drivers Support): New subsection. (Declaring Custom Test Drivers in @file{Makefile.am}): Likewise. (APIs for Custom Test Drivers): Likewise. (Options): Update description of color-tests. * lib/am/check ($(TEST_SUITE_LOG)): Remove comments that have been moved into the manual. (recheck, recheck-html): Minor adjustments to better conform to the documentation (this should cause no semantic changes w.r.t. the former behaviour); minor improvements and extensions to existing comments. * tests/test-driver-create-log-dir.test: New test. * tests/test-driver-strip-vpath.test: Likewise. * tests/test-driver-global-log.test: Likewise. * tests/test-driver-recheck.test: Likewise. * tests/Makefile.am (TESTS): Update.
3605250b 2011-06-29 10:06:20 Merge branch 'master' into test-protocols * master: docs: explain why AM_TESTS_ENVIRONMENT must be semicolon-terminated docs: fix unportable example of AM_TESTS_ENVIRONMENT usage docs: avoid a footnote, some related rewordings and improvements Revert "docs: parallel-tests is not experimental anymore" docs: minor cosmetic fixes help: improve text about automatically-distributed files refactor: split 'usage' subroutine in automake tests: fix bug in 'autodist.test' parallel-tests: stricter checks on DISABLE_HARD_ERRORS support docs: parallel-tests is not experimental anymore check: document and test $(TEST_SUITE_LOG) overriding
47f596af 2011-06-29 09:53:31 Merge branch 'am-tests-environment' * am-tests-environment: docs: explain why AM_TESTS_ENVIRONMENT must be semicolon-terminated docs: fix unportable example of AM_TESTS_ENVIRONMENT usage
3e334a27 2011-06-29 09:44:14 docs: explain why AM_TESTS_ENVIRONMENT must be semicolon-terminated * doc/automake.texi (Simple Tests using parallel-tests): Ditto, and related adjustments. Suggestion by Ralf Wildenhues.
69bb2561 2011-06-23 19:05:44 docs: fix unportable example of AM_TESTS_ENVIRONMENT usage * doc/automake.texi (Simple Tests using parallel-tests): The old example on AM_TESTS_ENVIRONMENT relied on unportable shell features, and in particular didn't work with various Korn Shells (see also commit `v1.11-925-g29ca903'). Give another example, simpler this time, but still inspired to real-world usage (the GNU coreutils testsuite).
b1109e2f 2011-06-28 11:26:15 Merge branch 'maint' * maint: Revert "docs: parallel-tests is not experimental anymore" parallel-tests: stricter checks on DISABLE_HARD_ERRORS support docs: parallel-tests is not experimental anymore check: document and test $(TEST_SUITE_LOG) overriding
c9e39919 2011-06-28 08:15:21 Merge branch 'parallel-tests-maint' into maint * parallel-tests-maint: Revert "docs: parallel-tests is not experimental anymore" parallel-tests: stricter checks on DISABLE_HARD_ERRORS support docs: parallel-tests is not experimental anymore check: document and test $(TEST_SUITE_LOG) overriding
d4977609 2011-06-27 15:36:37 Merge branch 'maint' * maint: docs: avoid a footnote, some related rewordings and improvements docs: minor cosmetic fixes
404882ab 2011-06-23 23:31:27 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.
9667c39a 2011-06-24 09:15:14 Revert "docs: parallel-tests is not experimental anymore" This reverts commit a9eef973b5ea47cc3495f1a8307d4f7b85aea46f. It turned out that the current work to introduce TAP and SubUnit support in Automake-generated testsuite harnesses will probably require the introduction of slight incompatibilities in the 'parallel-tests' behaviour, starting from release 1.12 onward. So it's advisable to continue to characterize the 'parallel-tests' support as "experimental" in maintenance release 1.11.2. Suggestion from Ralf Wildenhues.
5755b7bc 2011-06-23 18:38:34 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.
1f2e5599 2011-06-23 10:52:08 Merge branch 'maint' * maint: help: improve text about automatically-distributed files refactor: split 'usage' subroutine in automake
c1040a74 2011-01-12 01:27:07 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.
a27c9c49 2011-05-10 11:30:05 parallel-tests: add auxiliary script 'test-driver', refactor This refactoring should cause no API of functionality change, and is meant only to simplify the future implementation of TAP and SubUnit testsuite drivers. More precisely, our roadmap is to move most of the "testsuite driving" features out of the Automake-generated Makefiles, and into external scripts with well-defined interfaces. This will allow the user to define its own personalized testsuite drivers, and will also offer us a framework upon which to implement our new TAP and SubUnit drivers, all in a very unobtrusive way and retaining an high degree of code reuse and backward-compatibility. * lib/test-driver: New auxiliary script. * lib/Makefile.am (dist_SCRIPT_DATA): Add it. * automake.in (handle_tests): Require the new auxiliary script `test-driver', and define a new internal makefile variable `$(am__test_driver)', used to call it. Perform new substitution on `DRIVER' when processing the `check2.am' file. * lib/check.am (am__tty_colors): Define new shell variable `$am__color_tests'. (am__rst_section): Removed, its role taken over by the new `test-driver' script. (am__test_driver_flags): New variable, contains the command line options passed to `test-driver'. (am__check_pre): Do not deal with temporary files and exit traps anymore, as the `test-driver' script takes care of that now. Define shell variable `$am__enable_hard_errors', used by `$(am__test_driver_flags)'. Reorder so that we don't need to save and restore the value of the `TERM' environment variable anymore. Other related adjustments. (am__check_post): Remove, as its role has been completely taken over by the `test-driver' script. * am/check2.am (?GENERIC?%EXT%$(EXEEXT).log, ?GENERIC?%EXT%.log, ?!GENERIC?%OBJ%): Call the test script through the Automake substituted `%DRIVER%', and honor the command-line options in `$(am__test_driver_flags)'. Do not call the obsoleted `$(am__check_post)' anymore. * doc/automake.texi (Auxiliary Programs): Mention the new `test-driver' script. (Optional): Mention `test-driver' in AC_CONFIG_AUX_DIR. Since we are at it, break the list of auxiliary scripts by placing one per line, to simplify potential future additions of new scripts. * tests/check.test: Adjust. * tests/check2.test : Likewise. * tests/check3.test : Likewise. * tests/check4.test : Likewise. * tests/check10.test: Likewise. * tests/color.test: Likewise. * tests/color2.test: Likewise. * tests/comment9.test: Likewise. * tests/dejagnu.test: Likewise. * tests/exeext4.test: Likewise. * tests/maken3.test: Likewise. * tests/maken4.test: Likewise. * tests/parallel-tests-interrupt.test: Likewise. * tests/posixsubst-tests.test: Likewise. * tests/repeated-options.test: Likewise. * tests/check-no-test-driver.test: New test. * tests/parallel-test-driver-install.test: Likewise. * tests/Makefile.am (TESTS): Update. * NEWS: Update.
9b614944 2011-06-20 10:49:09 Merge branch 'maint' into parallel-tests-maint * maint: check: don't use multi-line coloring for the report ansi2knr: deprecate, it will go away in the next major release docs: primary/prefix combination "pkglib_PROGRAMS" is now invalid docs: replace obsolete @vindex entry with a useful one docs: AM_DISTCHECK_CONFIGURE_FLAGS is for corner cases
583daa1e 2011-06-20 10:46:09 Merge branch 'maint' * maint: check: don't use multi-line coloring for the report ansi2knr: deprecate, it will go away in the next major release docs: primary/prefix combination "pkglib_PROGRAMS" is now invalid docs: replace obsolete @vindex entry with a useful one docs: AM_DISTCHECK_CONFIGURE_FLAGS is for corner cases
60cd9bc0 2011-06-20 09:43:25 Merge branch 'am-distcheck-configure-flags' into maint
98fab124 2011-06-13 21:27:35 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.
f541f9a4 2011-06-19 13:15:49 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'.
d30f97d1 2011-06-19 12:32:59 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.
474aad06 2011-06-15 10:50:03 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.
e8bcc480 2011-06-16 17:21:00 Merge branch 'maint' into parallel-tests-maint * maint: news: update w.r.t. introduction of AM_DISTCHECK_CONFIGURE_FLAGS tests: optimize tests on primary/prefix mismatch for speed Warnings about primary/prefix mismatch fixed and extended. maintcheck: DISTCHECK_CONFIGURE_FLAGS can be defined on make cmdline distcheck: add support for AM_DISTCHECK_CONFIGURE_FLAGS docs: better documentation for silent make rules
43d62e07 2011-06-16 16:56:36 Merge branch 'maint' * maint: news: update w.r.t. introduction of AM_DISTCHECK_CONFIGURE_FLAGS tests: optimize tests on primary/prefix mismatch for speed Warnings about primary/prefix mismatch fixed and extended. maintcheck: DISTCHECK_CONFIGURE_FLAGS can be defined on make cmdline distcheck: add support for AM_DISTCHECK_CONFIGURE_FLAGS docs: better documentation for silent make rules
66249f44 2011-06-13 20:16:16 Merge branch 'am-distcheck-configure-flags' into maint * am-distcheck-configure-flags: maintcheck: DISTCHECK_CONFIGURE_FLAGS can be defined on make cmdline distcheck: add support for AM_DISTCHECK_CONFIGURE_FLAGS
97600392 2011-06-10 12:26:42 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#8487.
f4599943 2010-11-12 20:26:59 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.
e4a70cff 2011-06-03 11:37:46 Merge branch 'maint' into parallel-tests-maint * maint: maintcheck: fix some failures, extend some checks automake, aclocal: honour configure-time AUTOCONF and AUTOM4TE build: the user can override AUTOM4TE, AUTORECONF and AUTOUPDATE too remake: behave better with non-GNU make in subdirectories tests/README: fix example about `make -e' usage
8217b623 2011-06-02 12:17:40 Merge branch 'maint' * maint: maintcheck: fix some failures, extend some checks
24b9022b 2011-06-02 12:15:52 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.
3eb05919 2011-05-31 18:03:48 Merge branch 'maint' * maint: automake, aclocal: honour configure-time AUTOCONF and AUTOM4TE build: the user can override AUTOM4TE, AUTORECONF and AUTOUPDATE too tests/README: fix example about `make -e' usage
8a8890a9 2011-05-29 11:04:08 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.
a9eef973 2011-05-11 16:01:52 docs: parallel-tests is not experimental anymore The parallel-tests driver has now been used quite extensively by a fair number of real-world applications (e.g., GNU coreutils, GNU libtool, GNU grep, and various packages using Gnulib), and thus exposed to adequate on-field testing. So there's no point in declaring it experimental anymore (which would risk to make potential users shy away from it). * doc/automake.texi (Simple Tests using parallel-tests): Do not declare the parallel-tests driver as "experimental" anymore.
42a46524 2011-04-21 10:25:01 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.
feed175b 2011-04-19 09:46:53 Merge branch 'am-tests-environment'
12f48faf 2011-04-18 00:52:03 check: rename AM_TESTS_SETUP -> AM_TESTS_ENVIRONMENT The AM_TESTS_SETUP naming was not a good one after all. It may be technically more correct than AM_TESTS_ENVIRONMENT, but the latter is a better one simply because it is easier to remember, and even if you've never heard of it and only know the semantics of TESTS_ENVIRONMENT, you can have a straightforward way to figure out how AM_TESTS_ENVIRONMENT would work. * tests/check.am (am__check_pre): Update. * doc/automake.in (Simple Tests using parallel-tests): Update. * tests/parallel-tests-am_tests_setup.test: Renamed ... * tests/parallel-tests-am_tests_environment.test: ... to this, and updated. * tests/Makefile.am (TESTS): Update. Suggestion and motivation by Ralf Wildenhues.
0fea91c2 2011-04-17 15:21:34 Merge branch 'am-tests-setup'
95bbdf16 2011-01-24 11:34:32 check: new developer-reserved AM_TESTS_SETUP variable For reference, see the discussion at: <http://lists.gnu.org/archive/html/automake-patches/2011-01/msg00213.html> * lib/am/check.am [%?PARALLEL_TESTS%] (am__check_pre): Pass also $(AM_TESTS_SETUP). Comments updated, and some typos fixed. * doc/automake.texi (Simple Tests using parallel-tests): Document AM_TESTS_SETUP. Reorder some of the existing documentation a bit. * tests/parallel-tests-am_tests_setup.test: New test. From a suggestion by Ralf Wildenhues.
d555ae18 2011-04-02 16:00:23 Merge branch 'maint'
8d3571b9 2011-03-17 11:13:29 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.
95b717e8 2011-02-15 10:17:53 Merge branch 'maint'
5bf7af6e 2011-01-31 21:24:02 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.
6d0cfa31 2011-02-10 10:13:59 Merge branch 'python-tests-extend' Conflicts: tests/Makefile.am tests/Makefile.in tests/python11.test tests/python2.test tests/python8.test tests/python9.test
06b46e1f 2011-01-24 22:26:55 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.
e9d5de54 2011-01-22 18:31:12 Merge branch 'maint'
10315b6d 2011-01-19 20:20:37 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
1456186d 2011-01-16 12:15:19 Merge branch 'maint'
19a272ee 2011-01-14 15:18:36 Update docs w.r.t. warning and strictness options. * doc/automake.texi (Strictness): Document that some warnings are turned off by default in `foreign' strictness. (Options): Divide into new sections "Options generalities" and "List of Automake options". Fix typo (colon instead of full stop). Document option precedence (AUTOMAKE_OPTIONS wins over AM_INIT_AUTOMAKE which wins over command line). Also document interactions between options specifying strictness and those specifying warnings.
104926af 2011-01-15 14:54:51 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2872bbbd 2011-01-12 23:44:02 Merge branch 'doc-yacc-d-improve' into maint
38a9b5f6 2011-01-12 23:36:16 Merge branch 'yacc-work'
ba14eaec 2011-01-12 13:23:59 docs: clustered '-d' not recognized in YFLAGS This commit 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 Юрий Пухальский.
a71a5686 2011-01-09 15:30:42 Merge branch 'maint'
bb528a71 2011-01-09 15:22:32 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.
dcc0f400 2011-01-08 20:18:03 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
6880ecb2 2011-01-08 10:04:17 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
a297a165 2011-01-07 22:01:20 Merge branch 'yacc-clean'
d5a408d7 2010-12-24 22:00:40 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'). Suggested by Ralf Wildenhues.
3c9e7acc 2011-01-02 05:38:18 Merge branch 'maint'
511ccb16 2011-01-02 05:31:41 Bump copyright years. * aclocal.in (write_aclocal, version): Bump copyright years. * automake.in (gen_copyright, version): Likewise. * doc/automake.texi: Likewise. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
3fe9baba 2010-12-23 21:41:45 Merge branch 'tests-suffix-extend' Conflicts: tests/suffix10.test
d7430fea 2010-12-22 00:08:53 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).
3374fa0f 2010-12-18 12:22:49 Merge branch 'maint'
f6ab59ed 2010-12-18 12:17:14 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'.
4b285ef8 2010-12-16 19:47:36 docs: list LTLIBRARIES among Automake primaries * doc/automake.texi (Uniform): List `LTLIBRARIES' among the Automake primaries.
b6ee4603 2010-11-14 18:04:58 Merge branch 'maint'
aa45fb2c 2010-11-14 17:57:56 Rebuild menus in the manual. * doc/automake.texi: Rebuild menus (using ^C ^U ^A in emacs). Thanks to Ian Lance Taylor for the suggestion. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
a6da48d3 2010-11-14 17:53:49 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
37b0aeed 2010-11-13 12:21:28 Deprecate obsolete macro AM_WITH_REGEX. * m4/regex.m4: Document the `AM_WITH_REGEX' macro as obsolete, and state that it should be removed two years from now. (AM_WITH_REGEX): Raise an m4-time warning of the "obsolete" category when this macro is used. * doc/automake.texi (Public Macros): Move description of `AM_WITH_REGEX' from here ... (Obsolete Macros): ... to here, and declare it as obsolete and "to be removed in a future version". * tests/regex-obsolete.test: New test. * tests/Makefile.am (TESTS): Update.
f7adc0f4 2010-11-06 20:32:48 Merge branch 'maint'
d7c1679b 2010-10-03 12:29:40 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
d3134dcb 2010-11-01 22:35:09 Merge branch 'maint'
a7ba28fd 2010-10-14 06:14:20 Add FAQ entry for bug reporting instructions. * doc/automake.texi (Reporting Bugs): New section. (Introduction): Refer to it. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
6da46f31 2010-10-02 22:30:02 dist-xz, dist-bzip2: don't hard-code -9: honor envvar settings * lib/am/distdir.am (dist-xz): Do not hard-code xz's -9: that made it impossible to override. Instead, use its XZ_OPT envvar, defaulting to -9 if not defined. Thus no change in behavior when XZ_OPT is not set, and now, this rule honors the setting of that envvar when it is set. Suggested by Lasse Collin. (dist-bzip2): Likewise for it's corresponding envvar: BZIP2. * NEWS (Miscellaneous changes): Mention it. * doc/automake.texi (The Types of Distributions): Describe the newly enabled environment variables.
f6b05bd1 2010-10-03 11:44:13 Merge branch 'maint'
b8c1325a 2010-10-03 11:42:12 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
6edafbb5 2010-10-02 20:25:53 Implement EXTRA_maude_DEPENDENCIES for programs and libraries. * automake.in (handle_programs, handle_libraries) (handle_ltlibraries): Mark EXTRA_*_DEPENDENCIES as recognized. * doc/automake.texi (Linking, Program and Library Variables) (LIBOBJS): Document EXTRA_*_DEPENDENCIES. * lib/am/library.am (%LIBRARY%): Also depend on $(EXTRA_%XLIBRARY%_DEPENDENCIES). * lib/am/ltlibrary.am (%LTLIBRARY%): Also depend on (%XLTLIBRARY%_DEPENDENCIES). * lib/am/program.am (%PROGRAM%%EXEEXT%): Also depend on $(EXTRA_%XPROGRAM%_DEPENDENCIES). * tests/extradep.test, tests/extradep2.test: New tests. * tests/Makefile.am (TESTS): Update. * NEWS: Update. Suggested by Eric Blake. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
ea1a4174 2010-09-26 16:39:45 Merge branch 'maint' Conflicts: Makefile.am Makefile.in lib/Automake/Configure_ac.pm
6bc30609 2010-09-22 22:31:22 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.
20abe4e5 2010-09-22 22:04:55 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.
c423cdb4 2010-09-22 21:26:09 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.
eb8aece5 2010-08-17 22:19:08 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.
f8ba1f4f 2010-08-17 19:23:47 Fix typo in manual (`Makefile.in' instead of `Makefile.am'). * doc/automake.texi (Automatic dependency tracking): Fix typo.
8f3f7d7a 2010-08-17 22:19:08 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.
92783d30 2010-08-17 19:23:47 Fix typo in manual (`Makefile.in' instead of `Makefile.am'). * doc/automake.texi (Automatic dependency tracking): Fix typo.
67211bd9 2010-08-16 22:26:23 Merge branch 'maint'
1194808c 2010-08-16 22:14:12 Don't hide the table of contents. * doc/automake.texi: Move the table of contents to the beginning. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
8426abf3 2010-08-09 21:36:32 Merge branch 'msvc' * msvc: Add new auxiliary 'ar-lib' script, wrapping Microsoft lib. Fix shell pattern negation in compile script.
9533d1f0 2010-08-01 08:38:05 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
f74062b3 2010-08-01 09:38:34 Merge branch 'msvc' * msvc: Wrap some MSVC options in the compile script.
da15b997 2010-08-01 08:38:05 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. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
b0f2ede9 2010-07-31 17:02:43 Merge branch 'maint'
b1d81838 2010-07-31 14:16:15 Add more hints for debugging make rules. * doc/automake.texi (Debugging Make Rules): Show command to find out expanded values of variables; point to makefile debugger. * THANKS: Update. Prompted by suggestion from Ludovic Courtès and Andy Wingo. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
294d1bf8 2010-07-27 21:54:33 Fix typo in the manual. * doc/automake.texi (Scripts): Fix typo. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
f54a09c3 2010-06-26 22:23:31 Merge branch 'maint'
9b72d668 2010-06-26 22:10:21 Update program --help output to match current GCS. * configure.ac: Set and substitute PACKAGE_URL if AC_PACKAGE_URL is not defined, for compatibility to Autoconf < 2.64. * Makefile.am (do_subst): Substitute PACKAGE_BUGREPORT and PACKAGE_URL. (sc_diff_automake_in_automake): Update number of diff lines for additional substitutions. * aclocal.in (usage): Use PACKAGE_BUGREPORT. Point to Automake home page and GNU general help page. * automake.in (usage): Likewise. * doc/automake.texi: New flag PACKAGE_BUGREPORT, to factor email address. (Introduction, Creating amhello, amhello Explained, Options): Use it throughout. * lib/Automake/Makefile.am (do_subst): Substitute PACKAGE_BUGREPORT. * lib/Automake/Config.in ($PACKAGE_BUGREPORT): New global. * lib/Automake/ChannelDefs.pm: Use it for footer of fatal messages. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
10152e93 2010-06-26 22:07:12 Clean up @var handling in the manual. * doc/automake.texi: Throughout the manual, lower-case @var names, replace a few one-character names. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
ccea7069 2010-06-21 21:08:13 Merge branch 'sl-yacc-work' * sl-yacc-work: Fix minor testsuite issues, update docs, for Yacc/Lex changes. Bugfix: $(AM_FLAGS)/$(FLAGS) precedence in Yacc/Lex. New tests, for bugs in Yacc/Lex AM_FLAGS and FLAGS precedence.
fee7d0d3 2010-06-21 20:56:08 Fix minor testsuite issues, update docs, for Yacc/Lex changes. * doc/automake.texi (Yacc and Lex): Mention AM_YFLAGS, YFLAGS and AM_LFLAGS, LFLAGS in the order in which they now appear in the rules. * NEWS: Update. * tests/lflags.test, tests/lflags2.test, tests/yflags.test, tests/yflags2.test: Prefer `make -e' over `make VAR=VAL', to please maintainer-check. Ensure generated C files contain a declaration, to please compilers. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>