Merge branch 'maint'
[platform/upstream/automake.git] / NEWS
diff --git a/NEWS b/NEWS
index 68d2929..1b2e190 100644 (file)
--- a/NEWS
+++ b/NEWS
-New in 1.11.0a:
-
 * WARNING: Future backward-incompatibilities!
 
-  - The support for the "obscure" multilib feature has been deprecated,
-    and will be moved out of the automake core in the next major Automake
-    release (1.12).
+  - Starting from the next major Automake version (1.13), the parallel
+    testsuite harness (previously only enabled by the 'parallel-tests'
+    option) will become the default one; the older serial testsuite
+    harness will still be available through the use of the 'serial-tests'
+    option.
+
+  - The following long-obsolete m4 macros will be removed in the
+    next major Automake version (1.13):
+
+      AM_PROG_CC_STDC:    superseded by AC_PROG_CC since October 2002
+      fp_PROG_CC_STDC:    broken alias for AM_PROG_CC_STDC
+      fp_WITH_DMALLOC:    old alias for AM_WITH_DMALLOC
+      AM_CONFIG_HEADER:   superseded by AC_CONFIG_HEADERS since July 2002
+      ud_PATH_LISPDIR:    old alias for AM_PATH_LISPDIR
+      jm_MAINTAINER_MODE: old alias for AM_MAINTAINER_MODE
+      ud_GNU_GETTEXT:     old alias for AM_GNU_GETTEXT
+      gm_PROG_LIBTOOL:    old alias for AC_PROG_LIBTOOL
+      fp_C_PROTOTYPES:    old alias for AM_C_PROTOTYPES (which was part
+                          of the now-removed automatic de-ANSI-fication
+                          support of Automake)
+
+  - All the "old alias" macros in 'm4/obsolete.m4' will be removed in
+    the next major Automake version (1.13).
+
+  - Support for the two- and three-arguments invocation forms of the
+    AM_INIT_AUTOMAKE macro will be deprecated in the next minor version
+    of Automake (1.12.1) and removed in the next major version (1.13).
+
+  - The long-obsolete (since 1.10) automake-provided $(mkdir_p) make
+    variable, @mkdir_p@ substitution and AM_PROG_MKDIR m4 macro will
+    all be deprecated in the next minor version of Automake (1.12.1)
+    and removed in the next major version (1.13).
+
+  - The '--acdir' option of aclocal is deprecated, and will probably
+    be removed in the next major Automake release (1.13).  You should
+    use the options '--automake-acdir' and '--system-acdir' instead
+    (which have been introduced in Automake 1.11.2).
 
-  - The support for ".log -> .html" conversion and the check-html and
-    recheck-html targets will be removed in the next major Automake
-    release (1.12).
+  - The exact order in which the directories in the aclocal macro
+    search path are looked up is probably going to be changed in the
+    next Automake release (1.13).
+
+New in 1.11a:
+
+* Obsolete features removed:
+
+  - Support for automatic de-ANSI-fication has been removed.
+
+  - The support for the "obscure" multilib feature has been removed
+    from Automake core (but remains available in the 'contrib/'
+    directory of the Automake distribution).
+
+  - Support for ".log -> .html" conversion and the check-html and
+    recheck-html targets has been removed from Automake core (but
+    remains available in the 'contrib/' directory of the Automake
+    distribution).
+
+  - The deprecated 'lzma' compression format for distribution archives
+    has been removed, in favor of 'xz' and 'lzip'.
+
+  - The obsolete AM_WITH_REGEX macro has been removed.
+
+  - The long-deprecated options '--output-dir', '--Werror' and
+    '--Wno-error' have been removed.
+
+  - The chapter on the history of Automake has been moved out of the
+    reference manual, into a new dedicated Texinfo file.
+
+* New targets:
+
+  - New 'cscope' target to build a cscope database for the source tree.
+
+* Changes to Automake-generated testsuite harnesses:
+
+  - The new automake option 'serial-tests' has been introduced.  It can
+    be used to explicitly instruct automake to use the older serial
+    testsuite harness.  This is still the default at the moment, but it
+    might change in future versions.
+
+  - Test scripts that exit with status 99 to signal an "hard error" (e.g.,
+    and unexpected or internal error, or a failure to set up the test case
+    scenario) have their outcome reported as an 'ERROR' now.  Previous
+    versions of automake reported such an outcome as a 'FAIL' (the only
+    difference with normal failures being that hard errors were counted
+    as failures even when the test originating them was listed in
+    XFAIL_TESTS).
+
+  - The testsuite summary displayed by the parallel-test harness has a
+    completely new format, that always list the numbers of passed, failed,
+    xfailed, xpassed, skipped and errored tests, even when these numbers
+    are zero (but using smart coloring when the color-tests option is in
+    effect).
+
+  - The default testsuite driver offered by the 'parallel-tests' option is
+    now implemented (partly at least) with the help of automake-provided
+    auxiliary scripts (e.g., 'test-driver'), instead of relying entirely
+    on code in the generated Makefile.in.
+    This has two noteworthy implications.  The first one is that projects
+    using the 'parallel-tests' option should now either run automake with
+    the '--add-missing' option, or manually copy the 'test-driver' script
+    into their tree.  The second, and more important, implication is that
+    now, when the 'parallel-tests' option is in use, TESTS_ENVIRONMENT can
+    not be used anymore to define a test runner, and the command specified
+    in LOG_COMPILER (and <ext>_LOG_COMPILER) must be a *real* executable
+    program or script.  For example, this is still a valid usage (albeit
+    a little contorted):
+
+      TESTS_ENVIRONMENT = \
+        if test -n '$(STRICT_TESTS)'; then \
+          maybe_errexit='-e'; \
+        else \
+          maybe_errexit=''; \
+        fi;
+      LOG_COMPILER = $(SHELL) $$maybe_errexit
+
+    while this is not anymore:
+
+      TESTS_ENVIRONMENT = \
+        $(SHELL) `test -n '$(STRICT_TESTS_CHECKING)' && echo ' -e'`
+
+    neither is this:
+
+      TESTS_ENVIRONMENT = \
+        run_with_perl_or_shell () \
+        { \
+          if grep -q '^#!.*perl' $$1; then
+            $(PERL) $$1; \
+          else \
+            $(SHELL) $$1; \
+          fi; \
+        }
+      LOG_COMPILER = run_with_per_or_shell
+
+  - The package authors can now use customary testsuite drivers within
+    the framework provided by the 'parallel-tests' testsuite harness.
+    Consistently with the existing syntax, this can be done by defining
+    special makefile variables 'LOG_DRIVER' and '<ext>_LOG_DRIVER'.
+
+  - A new developer-reserved variable 'AM_TESTS_FD_REDIRECT' can be used
+    to redirect/define file descriptors used by the test scripts.
+
+  - The parallel-tests harness generates now, in addition the '.log' files
+    holding the output produced by the test scripts, a new set of '.trs'
+    files, holding "metadata" derived by the execution of the test scripts;
+    among such metadata are the outcomes of the test cases run by a script.
+
+  - Initial and still experimental support for the TAP test protocol is
+    now provided.
+
+* Changes to Yacc and Lex support:
+
+  - C source and header files derived from non-distributed Yacc and/or
+    Lex sources are now removed by a simple "make clean" (while they were
+    previously removed only by "make maintainer-clean").
+
+  - Slightly backward-incompatible change, relevant only for use of Yacc
+    with C++: the extensions of the header files produced by the Yacc
+    rules are now modelled after the extension of the corresponding
+    sources.  For example, yacc files named "foo.y++" and "bar.yy" will
+    produce header files named "foo.h++" and "bar.hh" respectively, where
+    they would have previously produced header files named simply "foo.h"
+    and "bar.h".  This change offers better compatibility with 'bison -o'.
 
-  - The `lzma' compression format for distribution archives has been
-    deprecated in favor of `xz' and `lzip', and will be removed in the
-    next major Automake release (1.12).
+* Miscellaneous changes:
 
-  - The Automake support for automatic de-ANSI-fication will be removed in
-    the next major Automake release (1.12).
+  - Automake now prefers to quote 'like this' or "like this", rather
+    than `like this', in diagnostic message and generated Makefiles,
+    to accommodate the new GNU Coding Standards recommendations.
 
-  - The `--acdir' option of aclocal is deprecated, and will probably be
-    removed in the next major Automake release (1.12).
+  - Automake has a new option '--print-libdir' that prints the path of the
+    directory containing the Automake-provided scripts and data files.
 
-  - The exact order in which the directories in the aclocal macro
-    search path are looked up is probably going to be changed in the
-    next Automake release (1.12).
+  - The 'dist' and 'dist-all' targets now can run compressors in parallel.
 
-  - The obsolescent AM_WITH_REGEX  macro has been deprecated (since the
-    GNU rx library has been decommissioned), and will be removed in the
-    next major Automake release (1.12).
+  - Automake can now generate silenced rules for texinfo outputs.
 
-* Changes to aclocal:
+  - Some auxiliary files that are automatically distributed by Automake
+    (e.g., 'install-sh', or the 'depcomp' script for packages compiling
+    C sources) might now be listed in the DIST_COMMON variable in many
+    Makefile.in files, rather than in the top-level one.
 
-  - The `--acdir' option is deprecated.  Now you should use the new options
-    `--automake-acdir' and `--system-acdir' instead.
+  - Messages of types warning or error from 'automake' and 'aclocal'
+    are now prefixed with the respective type, and presence of -Werror
+    is noted.
 
-  - The `ACLOCAL_PATH' environment variable is now interpreted as a
-    colon-separated list of additional directories to search after the
-    automake internal acdir (by default ${prefix}/share/aclocal-APIVERSION)
-    and before the system acdir (by default ${prefix}/share/aclocal).
+  - Automake's early configure-time sanity check now tries to avoid
+    sleeping for a second, which slowed down cached configure runs
+    noticeably.  In that case, it will check back at the end of the
+    configure script to ensure that at least one second has passed, to
+    avoid time stamp issues with makefile rules rerunning autotools
+    programs.
+
+  - For programs and libraries, automake now detect EXTRA_foo_DEPENDENCIES
+    and adds them to the normal list of dependencies, but without
+    overwriting the foo_DEPENDENCIES variable, which is normally computed
+    by automake.
+
+  - The warnings in the category 'extra-portability' are now enabled by
+    '-Wall'.  In previous versions, one has to use '-Wextra-portability'
+    to enable them.
+
+  - The 'ar-lib' script now ignores the "s" (symbol index) and "S" (no
+    symbol index) modifiers as well as the "s" action, as the symbol index
+    is created unconditionally by Microsoft lib.  Also, the "q" (quick)
+    action is now a synonym for "r" (replace).  Also, the script has been
+    ignoring the "v" (verbose) modifier already since Automake 1.11.3.
+
+  - When the 'compile' script is used to wrap MSVC, it now accepts an
+    optional space between the -I, -L and -l options and their respective
+    arguments, for better POSIX compliance.
+
+Bugs fixed in 1.11a:
+
+  - Various minor bugfixes for recent or long-standing bugs.
+
+* Bugs introduced by 1.11:
+
+  - The AM_COND_IF macro also works if the shell expression for the
+    conditional is no longer valid for the condition.
+
+  - The automake-provided parallel testsuite harness does not fail anymore
+    with BSD make used in parallel mode when there are test scripts in a
+    subdirectory, like in:
+
+      TESTS = sub/foo.test sub/bar.test
+
+* Long-standing bugs:
+
+  - It is now possible for a foo_SOURCES variable to hold Vala sources
+    together with C header files, as well as with sources and headers for
+    other supported languages (e.g., C++).  Previously, only mixing C and
+    Vala sources was supported.
+
+  - Automake's own build system finally have a real "installcheck" target.
+
+  - Files listed with the AC_REQUIRE_AUX_FILE macro in configure.ac are
+    now automatically distributed also if the directory of the auxiliary
+    files coincides with the top-level directory.
+
+  - Automake now detects the presence of the '-d' flag in the various
+    '*YFLAGS' variables even when their definitions involve indirections
+    through other variables, such as in:
+      foo_opts = -d
+      AM_YFLAGS = $(foo_opts)
+
+  - Automake now complains if a '*YFLAGS' variable has any conditional
+    content, not only a conditional definition.
+
+  - Explicit enabling and/or disabling of Automake warning categories
+    through the '-W...' options now always takes precedence over the
+    implicit warning level implied by Automake strictness (foreign, gnu
+    or gnits), regardless of the order in which such strictness and
+    warning flags appear.  For example, a setting like:
+      AUTOMAKE_OPTIONS = -Wall --foreign
+    will cause the warnings in category 'portability' to be enabled, even
+    if those warnings are by default disabled in 'foreign' strictness.
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+New in 1.11.3:
+
+* WARNING: Future backward-incompatibilities!
+
+  - The obsolescent AM_WITH_REGEX  macro has been deprecated, since the
+    GNU rx library has been decommissioned.
+
+  - The `lzma' compression format for distribution archives has been
+    deprecated in favor of `xz' and `lzip'.
 
 * Miscellaneous changes:
 
@@ -70,6 +301,42 @@ New in 1.11.0a:
   - The last relics of Python 1.5 support have been removed from the
     AM_PATH_PYTHON macro.
 
+Bugs fixed in 1.11.3:
+
+* Long-standing bugs:
+
+  - The "deleted header file problem" for *.am files is avoided by stub
+    rules.  This allows `make' to trigger a rerun of `automake' also if
+    some previously needed `.am' file has been removed.
+
+  - The `silent-rules' option now generates working makefiles even
+    for the uncommon `make' implementations that do not support the
+    nested-variables extension to POSIX 2008.  For such `make'
+    implementations, whether a build is silent is determined at
+    configure time, and cannot be overridden at make time with
+    `make V=0' or `make V=1'.
+
+  - Vala support now works better in VPATH setups.
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+New in 1.11.2:
+
+* Changes to aclocal:
+
+  - The `--acdir' option is deprecated.  Now you should use the new options
+    `--automake-acdir' and `--system-acdir' instead.
+
+  - The `ACLOCAL_PATH' environment variable is now interpreted as a
+    colon-separated list of additional directories to search after the
+    automake internal acdir (by default ${prefix}/share/aclocal-APIVERSION)
+    and before the system acdir (by default ${prefix}/share/aclocal).
+
+* Miscellaneous changes:
+
+  - The Automake support for automatic de-ANSI-fication has been
+    deprecated.
+
   - The `lzma' compression scheme and associated automake option `dist-lzma'
     is obsoleted by `xz' and `dist-xz' due to upstream changes.
 
@@ -78,6 +345,9 @@ New in 1.11.0a:
     specify a different level via the XZ_OPT and BZIP2 envvars respectively.
     E.g., "make dist-xz XZ_OPT=-7" or "make dist-bzip2 BZIP2=-5"
 
+  - The `compile' script now converts some options for MSVC for a better
+    user experience.  Similarly, the new `ar-lib' script wraps Microsoft lib.
+
   - The py-compile script now accepts empty arguments passed to the options
     `--destdir' and `--basedir', and complains about unrecognized options.
     Moreover, a non-option argument or a special `--' argument terminates
@@ -91,6 +361,11 @@ New in 1.11.0a:
     user; still, the old Makefile.am files that used to define it will
     still continue to work as before.
 
+  - New macro AM_PROG_AR that looks for an archiver and wraps it in the new
+    'ar-lib' auxiliary script if the selected archiver is Microsoft lib.
+    This new macro is required for LIBRARIES and LTLIBRARIES when automake
+    is run with -Wextra-portability and -Werror.
+
   - When using DejaGnu-based testsuites, the user can extend the `site.exp'
     file generated by automake-provided rules by defining the special make
     variable `$(EXTRA_DEJAGNU_SITE_CONFIG)'.
@@ -99,12 +374,7 @@ New in 1.11.0a:
     the `${infodir}/dir' file, by exporting the new environment variable
     `AM_UPDATE_INFO_DIR' to the value "no".
 
-  - For programs and libraries, automake now detects EXTRA_foo_DEPENDENCIES
-    and adds them to the normal list of dependencies, but without
-    overwriting the foo_DEPENDENCIES variable, which is normally computed
-    by automake.
-
-Bugs fixed in 1.11.0a:
+Bugs fixed in 1.11.2:
 
 * Bugs introduced by 1.11.2:
 
@@ -113,14 +383,11 @@ Bugs fixed in 1.11.0a:
 
 * Bugs introduced by 1.11:
 
-  - The parallel-tests harness doesn't trip anymore on sed implementations
-    with stricter limits on the length of input lines (problem seen at
-    least on Solaris 8).
+  - The parallel-tests driver no longer produces erroneous results with
+    Tru64/OSF 5.1 sh upon unreadable log files.
 
-  - The `parallel-tests' test driver works around a GNU make 3.80 bug with
-    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 `parallel-tests' test driver does not report spurious successes
+    when used with concurrent FreeBSD make (e.g., "make check -j3").
 
   - When the parallel-tests driver is in use, automake now explicitly
     rejects invalid entries and conditional contents in TEST_EXTENSIONS,
@@ -134,28 +401,14 @@ Bugs fixed in 1.11.0a:
     not used, `make' output no longer contains spurious backslash-only
     lines, thus once again matching what Automake did before 1.11.
 
-  - The `silent-rules' option now generates working makefiles even for
-    the uncommon `make' implementations that do not support the
-    nested-variables extension to POSIX 2008.  For such `make'
-    implementations, whether a build is silent is determined at
-    configure time, and cannot be overridden at make time with
-    `make V=0' or `make V=1'.
-
-  - The AM_COND_IF macro also works if the shell expression for the conditional
-    is no longer valid for the condition.
+  - The AM_COND_IF macro also works if the shell expression for the
+    conditional is no longer valid for the condition.
 
 * Long-standing bugs:
 
-  - It is now possible for a foo_SOURCES variable to hold Vala sources
-    together with C header files, as well as with sources and headers for
-    other supported languages (e.g., C++).  Previously, only mixing C and
-    Vala sources was supported.
-
-  - Vala support now works better in VPATH setups.
-
-  - The "deleted header file problem" for *.am files is avoided by stub
-    rules.  This allows `make' to trigger a rerun of `automake' also if
-    some previously needed `.am' file has been removed.
+  - 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.
 
   - "make distcheck" now correctly complains also when "make uninstall"
     leaves one and only one file installed in $(prefix).
@@ -167,17 +420,9 @@ Bugs fixed in 1.11.0a:
   - 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
-    `get_python_lib' function if it points outside the configured prefix,
-    unless the `--prefix' argument was either `/usr' or below `/System'.
-
-  - The testsuite does not try to change the mode of `ltmain.sh' files from
-    a Libtool installation (symlinked to test directories) any more.
-
-  - AM_PROG_GCJ uses AC_CHECK_TOOLS to look for `gcj' now, so that prefixed
-    tools are preferred in a cross-compile setup.
+  - 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.
 
   - Several scripts and the parallel-tests testsuite driver now exit with
     the right exit status upon receiving a signal.
@@ -185,21 +430,10 @@ Bugs fixed in 1.11.0a:
   - A per-Makefile.am setting of -Werror does not erroneously carry over
     to the handling of other Makefile.am files.
 
-  - The order of Yacc and Lex flags is now consistent with that of 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 not to 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 no longer produces erroneous results with
-    Tru64/OSF 5.1 sh upon unreadable log files.
-
   - The makedepend and hp depmodes now work better with VPATH builds.
 
   - Java sources specified with check_JAVA are no longer compiled for
@@ -216,7 +450,39 @@ Bugs fixed in 1.11.0a:
     `install-info' program is from Debian or from GNU, and adaptively
     change its behaviour; this has proven to be frail and easy to
     regress.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Bugs fixed in 1.11.1:
+
+  - Lots of minor bugfixes.
+
+* 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)').
+
+* Long standing bugs:
+
+  - 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
+    `get_python_lib' function if it points outside the configured prefix,
+    unless the `--prefix' argument was either `/usr' or below `/System'.
+
+  - The testsuite does not try to change the mode of `ltmain.sh' files from
+    a Libtool installation (symlinked to test directories) any more.
+
+  - AM_PROG_GCJ uses AC_CHECK_TOOLS to look for `gcj' now, so that prefixed
+    tools are preferred in a cross-compile setup.
+
+  - The distribution is tarred up with mode 755 now by the `dist*' targets.
+    This fixes a race condition where untrusted users could modify files
+    in the $(PACKAGE)-$(VERSION) distdir before packing if the toplevel
+    build directory was world-searchable.  This is CVE-2009-4029.
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 New in 1.11:
 
 * Version requirements:
@@ -453,7 +719,9 @@ Bugs fixed in 1.11:
 
   - Fix order of standard includes to again be `-I. -I$(srcdir)',
     followed by directories containing config headers.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 New in 1.10:
 
 * Version requirements:
@@ -621,7 +889,9 @@ New in 1.10:
   - Automake installs a "Hello World!" example package in $(docdir).
     This example is used throughout the new "Autotools Introduction"
     chapter of the manual.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 New in 1.9:
 
 * Makefile.in bloat reduction:
@@ -717,7 +987,9 @@ New in 1.9:
 
   - The manual tells more about SUBDIRS vs. DIST_SUBDIRS.
     It also gives an example of nested packages using AC_CONFIG_SUBDIRS.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Bugs fixed in 1.8.5:
 
 * Long-standing bugs:
@@ -730,7 +1002,9 @@ Bugs fixed in 1.8.5:
   - Fix many rules to please FreeBSD make, which runs commands with `sh -e'.
 
   - Polish diagnostic when no input file is found.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Bugs fixed in 1.8.4:
 
 * Long-standing bugs:
@@ -757,7 +1031,9 @@ Bugs fixed in 1.8.4:
     not defined in the same conditions as the _LDADD that uses it.
 
   - Do not warn when JAVAROOT is overridden, this is legitimate.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Bugs fixed in 1.8.3:
 
 * Long-standing bugs:
@@ -825,7 +1101,9 @@ Bugs fixed in 1.8.3:
   - Third-Party Makefiles: how to interface third party Makefiles.
   - Upgrading: upgrading packages to newer Automake versions.
   - Multiple Outputs: handling tools that produce many outputs.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Bug fixed in 1.8.2:
 
 * A (well known) portability bug slipped in the changes made to
@@ -834,7 +1112,9 @@ Bug fixed in 1.8.2:
 
 * Fix install rules for conditionally built python files.  (This never
   really worked.)
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Bug fixed in 1.8.1:
 
 * Bugs introduced by 1.8:
@@ -943,7 +1223,9 @@ Bug fixed in 1.8.1:
   - tests/aclocal6.test: fix failure if autom4te.cache is disabled.
   - tests/txinfo24.test, tests/txinfo25.test, tests/txinfo28.test:
     fix failures with old Texinfo versions.
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 New in 1.8:
 
 * Meta-News
@@ -1227,19 +1509,21 @@ New in 1.8:
   - CONFIGURE_DEPENDENCIES and CONFIG_STATUS_DEPENDENCIES are now
     documented.  (The is not a new feature, these variables have
     been there since at least Automake 1.4.)
-\f
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Bugs fixed in 1.7.9:
 * Fix install-strip to work with nobase_ binaries.
 * Fix renaming of #line directives in ylwrap.
 * Rebuild with Autoconf 2.59.  (1.7.8 was not installable with pdksh.)
-\f
+
 Bugs fixed in 1.7.8:
 * Remove spurious blank lines in cleaning rules introduced in 1.7.7.
 * Fix detection of Debian's install-info, broken since version 1.5.
   (Debian bug #213524).
 * Honor -module if it appears in AM_LDFLAGS (i.e., relax name checking)
   This was only done for libfoo_LDFLAGS and LDFLAGS in previous versions.
-\f
+
 Bugs fixed in 1.7.7:
 * The implementation of automake's --no-force option is unreliable,
   so this option is ignored in this version.  A real fix will appear in
@@ -1256,7 +1540,7 @@ Bugs fixed in 1.7.7:
   - Extending aclocal: how to write m4 macros that won't trigger warnings
     with Automake 1.8.
   - A Shared Library: Rewrite and split into subsections.
-\f
+
 Bugs fixed in 1.7.6:
 * Fix depcomp's icc mode for ICC 7.1.
 * Diagnose calls to AC_CONFIG_FILES and friends with not enough arguments.
@@ -1265,7 +1549,7 @@ Bugs fixed in 1.7.6:
 * Fix the location reported in some diagnostics related to AUTOMAKE_OPTIONS.
 * Remove Latin-1 characters from elisp-comp.
 * Update the manual's @dircategory to match the Free Software Directory.
-\f
+
 Bugs fixed in 1.7.5:
 * Update install-sh's license to remove an advertising clause.
   (Debian bug #191717)
@@ -1273,7 +1557,7 @@ Bugs fixed in 1.7.5:
   that caused invalid Makefile.ins to be generated.
 * Make sure AM_MAKE_INCLUDE doesn't fail when a `doit' file exists.
 * New FAQ entry: renamed objects.
-\f
+
 Bugs fixed in 1.7.4:
 * Tweak the TAGS rule to support Exuberant Ctags (in addition to
   the Emacs implementation)
@@ -1289,7 +1573,7 @@ Bugs fixed in 1.7.4:
   Makefiles. (PR/389)
 * `make install' will build `BUILT_SOURCES' first.
 * Minor documentation fixes.
-\f
+
 Bugs fixed in 1.7.3:
 * Fix stamp files numbering (when using multiple AC_CONFIG_HEADERS).
 * Query distutils for `pythondir' and `pythonexecdir', instead of
@@ -1321,7 +1605,7 @@ Bugs fixed in 1.7.3:
   - Document how AC_CONFIG_AUX_DIR interacts with missing files.
     (Debian Bug #39542)
   - Document `AM_YFLAGS = -d'.  (PR/382)
-\f
+
 Bugs fixed in 1.7.2:
 * Fix installation and uninstallation of Info files built in subdirectories.
 * Do not run `./configure --with-included-gettext' during `make distcheck'
@@ -1331,7 +1615,7 @@ Bugs fixed in 1.7.2:
   and augmented in another condition.
 * Fix ansi2knr rules for LIBOBJS sources.
 * Clean all known Texinfo index files, not only those which appear to
-  be used, because we cannot know wich indexes are used in included files.
+  be used, because we cannot know which indexes are used in included files.
   (PR/375, Debian Bug #168671)
 * Honor only the first @setfilename seen in a Texinfo file.
 * Treat "required file X not found" diagnostics as errors (exit status 1).
@@ -1351,7 +1635,7 @@ Bugs fixed in 1.7.2:
 * Noteworthy manual updates:
   - Augment the section about BUILT_SOURCES.
   - Mention that AM_PROG_CC_STDC is a relic that is better avoided today.
-\f
+
 Bugs fixed in 1.7.1:
 * Honor `ansi2knr' for files built in subdirectories, or using per-targets
   flags.
@@ -1377,7 +1661,7 @@ Bugs fixed in 1.7.1:
 * Fix distribution of included Makefile fragment, so we don't create
   spurious directories in the distribution. (PR/366)
 * Don't complain that a target lacks `.$(EXEEXT)' when it has it.
-\f
+
 New in 1.7:
 * Autoconf 2.54 is required.
 * `aclocal' and `automake' will no longer warn about obsolete
@@ -1413,7 +1697,7 @@ New in 1.7:
   removes all installed files has been moved in a separate target,
   distuninstallcheck, so it can be overridden easily.
 * Many bug fixes.
-\f
+
 New in 1.6.3:
 * Support for AM_INIT_GETTEXT([external])
 * Bug fixes, including:
@@ -1421,7 +1705,7 @@ New in 1.6.3:
   - nobase_ programs and scripts honor --program-transform correctly.
   - Erase configure.lineno during `make distclean'.
   - Erase YACC and LEX outputs during `make maintainer-clean'.
-\f
+
 New in 1.6.2:
 * Many bug fixes, including:
   - Requiring the current version works.
@@ -1431,7 +1715,7 @@ New in 1.6.2:
   - Don't compute dependencies in background to avoid races with libtool.
   - Fix handling of _OBJECTS variables for targets sharing source variables.
   - Check dependency mode for Java when AM_PROG_GCJ is used.
-\f
+
 New in 1.6.1:
 * automake --output-dir is deprecated
 * Many bug fixes, including:
@@ -1440,7 +1724,7 @@ New in 1.6.1:
   - Allow configure variables with reserved suffix and unknown prefix
     (e.g. AC_SUBST(mumble_LDFLAGS) when 'mumble' is not a target).
   - Fix the definition of AUTOMAKE and ACLOCAL in configure.
-\f
+
 New in 1.6:
 * Autoconf 2.52 is required.
 * automake no longer run libtoolize.
@@ -1478,7 +1762,7 @@ New in 1.6:
   appended, and some of the install directory names have changed.
   This lets you have multiple versions installed simultaneously.
 * Support for parsers and lexers in subdirectories.
-\f
+
 New in 1.5:
 * Support for `configure.ac'.
 * Support for `else COND', `endif COND' and negated conditions `!COND'.
@@ -1496,7 +1780,7 @@ New in 1.5:
 * Compiled Java support
 * Support for per-executable and per-library compilation flags
 * Many bug fixes
-\f
+
 New in 1.4:
 * Added support for the Fortran 77 programming language.
 * Re-indexed the Automake Texinfo manual.
@@ -1508,7 +1792,7 @@ New in 1.4:
 * Dependency tracking no long susceptible to deleted header file problem
 * Maintainer mode now a conditional.  @MAINT@ is now an anachronism.
 * Bug fixes
-\f
+
 New in 1.3:
 * Bug fixes
 * Better Cygwin32 support
@@ -1524,7 +1808,7 @@ New in 1.3:
 * Preliminary support for Java
 * DESTDIR support at "make install" time
 * Improved ansi2knr support; you must use the latest ansi2knr.c (included)
-\f
+
 New in 1.2:
 * Bug fixes
 * Better DejaGnu support
@@ -1559,12 +1843,12 @@ New in 1.2:
 * Added `missing' support
 * Cygwin32 support
 * Conditionals in Makefile.am, from Ian Taylor
-\f
+
 New in 1.0:
 * Bug fixes
 * distcheck target runs install and installcheck targets
 * Added preliminary support for DejaGnu.
-\f
+
 New in 0.33:
 * More bug fixes
 * More checking
@@ -1573,7 +1857,7 @@ New in 0.33:
 * Added support for jm_MAINTAINER_MODE
 * dist-zip support
 * New "distcheck" target
-\f
+
 New in 0.32:
 * Many bug fixes
 * mkinstalldirs and mdate-sh now appear in directory specified by
@@ -1585,7 +1869,7 @@ New in 0.32:
 * Preliminary (unfinished) support for libtool
 * Added short option names.
 * Better "dist" support when gluing together multiple packages
-\f
+
 New in 0.31:
 * Bug fixes
 * Documentation updates (many from François Pinard)
@@ -1599,7 +1883,7 @@ New in 0.31:
 * Better error messages in many cases
 * Program names are canonicalized
 * Added "check" prefix; from Gord Matzigkeit
-\f
+
 New in 0.30:
 * Bug fixes
 * configure.in scanner knows about AC_PATH_XTRA, AC_OUTPUT ":" syntax
@@ -1615,7 +1899,7 @@ New in 0.30:
 * Required macros now distributed in aclocal.m4
 * New documentation
 * --strictness=gnu is default
-\f
+
 New in 0.29:
 * Many bug fixes
 * More sophisticated configure.in scanning; now understands ALLOCA and
@@ -1628,7 +1912,7 @@ New in 0.29:
   foo_SOURCES variable.
 * Automake automatically rebuilds files listed in AC_OUTPUT.  The
   corresponding ".in" files are included in the distribution.
-\f
+
 New in 0.28:
 * Added --gnu and --gnits options
 * More standards checking
@@ -1636,10 +1920,10 @@ New in 0.28:
 * Cleaned up 'dist' targets
 * Added AUTOMAKE_OPTIONS variable and several options
 * Now scans configure.in to get some information (preliminary)
-\f
+
 New in 0.27:
 * Works with Perl 4 again
-\f
+
 New in 0.26:
 * Added --install-missing option.
 * Pretty-prints generated macros and rules
@@ -1647,11 +1931,11 @@ New in 0.26:
 * Generates .PHONY target
 * Rule or macro in Makefile.am now overrides contents of Automake file
 * Substantial cleanups from François Pinard
-\f
+
 New in 0.25:
 * Bug fixes.
 * Works with Perl 4 again.
-\f
+
 New in 0.24:
 * New uniform naming scheme.
 * --strictness option
@@ -1659,23 +1943,23 @@ New in 0.24:
 * '.c' files corresponding to '.y' or '.l' files are automatically
   distributed.
 * Many bug fixes and cleanups
-\f
+
 New in 0.23:
 * Allow objects to be conditionally included in libraries via lib_LIBADD.
-\f
+
 New in 0.22:
 * Bug fixes in 'clean' code.
 * Now generates 'installdirs' target.
 * man page installation reworked.
 * 'make dist' no longer re-creates all Makefile.in's.
-\f
+
 New in 0.21:
 * Reimplemented in Perl
 * Added --amdir option (for debugging)
 * Texinfo support cleaned up.
 * Automatic de-ANSI-fication cleaned up.
 * Cleaned up 'clean' targets.
-\f
+
 New in 0.20:
 * Automatic dependency tracking
 * More documentation
@@ -1687,9 +1971,7 @@ New in 0.20:
 
 -----
 
-Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
-2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011  Free Software
-Foundation, Inc.
+Copyright (C) 1995-2012 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