news: minor fixlets and reorganization
[platform/upstream/automake.git] / NEWS
1 * WARNING: Future backward-incompatibilities!
2
3   - The '--acdir' option of aclocal is deprecated, and will probably
4     be removed in the next major Automake release (1.13).  You should
5     use the options '--automake-acdir' and '--system-acdir' instead
6     (which have been introduced in Automake 1.11.2).
7
8   - The exact order in which the directories in the aclocal macro
9     search path are looked up is probably going to be changed in the
10     next Automake release (1.13).
11
12 New in 1.11a:
13
14 * Obsolete features removed:
15
16   - Support for automatic de-ANSI-fication has been removed.
17
18   - The support for the "obscure" multilib feature has been removed
19     from Automake core (but remains available in the 'contrib/'
20     directory of the Automake distribution).
21
22   - Support for ".log -> .html" conversion and the check-html and
23     recheck-html targets has been removed from Automake core (but
24     remains available in the 'contrib/' directory of the Automake
25     distribution).
26
27   - The deprecated 'lzma' compression format for distribution archives
28     has been removed, in favor of 'xz' and 'lzip'.
29
30   - The obsolete AM_WITH_REGEX macro has been removed.
31
32   - The long-deprecated options '--output-dir', '--Werror' and
33     '--Wno-error' have been removed.
34
35   - The chapter on the history of Automake has been moved out of the
36     reference manual, into a new dedicated Texinfo file.
37
38 * New targets:
39
40   - New 'cscope' target to build a cscope database for the source tree.
41
42 * Changes to Automake-generated testsuite harnesses:
43
44   - The new automake option 'serial-tests' has been introduced.  It can
45     be used to explicitly instruct automake to use the older serial
46     testsuite harness.  This is still the default at the moment, but it
47     might change in future versions.
48
49   - Test scripts that exit with status 99 to signal an "hard error" (e.g.,
50     and unexpected or internal error, or a failure to set up the test case
51     scenario) have their outcome reported as an 'ERROR' now.  Previous
52     versions of automake reported such an outcome as a 'FAIL' (the only
53     difference with normal failures being that hard errors were counted
54     as failures even when the test originating them was listed in
55     XFAIL_TESTS).
56
57   - The testsuite summary displayed by the parallel-test harness has a
58     completely new format, that always list the numbers of passed, failed,
59     xfailed, xpassed, skipped and errored tests, even when these numbers
60     are zero (but using smart coloring when the color-tests option is in
61     effect).
62
63   - The default testsuite driver offered by the 'parallel-tests' option is
64     now implemented (partly at least) with the help of automake-provided
65     auxiliary scripts (e.g., 'test-driver'), instead of relying entirely
66     on code in the generated Makefile.in.
67     This has two noteworthy implications.  The first one is that projects
68     using the 'parallel-tests' option should now either run automake with
69     the '--add-missing' option, or manually copy the 'test-driver' script
70     into their tree.  The second, and more important, implication is that
71     now, when the 'parallel-tests' option is in use, TESTS_ENVIRONMENT can
72     not be used anymore to define a test runner, and the command specified
73     in LOG_COMPILER (and <ext>_LOG_COMPILER) must be a *real* executable
74     program or script.  For example, this is still a valid usage (albeit
75     a little contorted):
76
77       TESTS_ENVIRONMENT = \
78         if test -n '$(STRICT_TESTS)'; then \
79           maybe_errexit='-e'; \
80         else \
81           maybe_errexit=''; \
82         fi;
83       LOG_COMPILER = $(SHELL) $$maybe_errexit
84
85     while this is not anymore:
86
87       TESTS_ENVIRONMENT = \
88         $(SHELL) `test -n '$(STRICT_TESTS_CHECKING)' && echo ' -e'`
89
90     neither is this:
91
92       TESTS_ENVIRONMENT = \
93         run_with_perl_or_shell () \
94         { \
95           if grep -q '^#!.*perl' $$1; then
96             $(PERL) $$1; \
97           else \
98             $(SHELL) $$1; \
99           fi; \
100         }
101       LOG_COMPILER = run_with_per_or_shell
102
103   - The package authors can now use customary testsuite drivers within
104     the framework provided by the 'parallel-tests' testsuite harness.
105     Consistently with the existing syntax, this can be done by defining
106     special makefile variables 'LOG_DRIVER' and '<ext>_LOG_DRIVER'.
107
108   - A new developer-reserved variable 'AM_TESTS_FD_REDIRECT' can be used
109     to redirect/define file descriptors used by the test scripts.
110
111   - The parallel-tests harness generates now, in addition the '.log' files
112     holding the output produced by the test scripts, a new set of '.trs'
113     files, holding "metadata" derived by the execution of the test scripts;
114     among such metadata are the outcomes of the test cases run by a script.
115
116   - Initial and still experimental support for the TAP test protocol is
117     now provided.
118
119 * Changes to Yacc and Lex support:
120
121   - C source and header files derived from non-distributed Yacc and/or
122     Lex sources are now removed by a simple "make clean" (while they were
123     previously removed only by "make maintainer-clean").
124
125   - Slightly backward-incompatible change, relevant only for use of Yacc
126     with C++: the extensions of the header files produced by the Yacc
127     rules are now modelled after the extension of the corresponding
128     sources.  For example, yacc files named "foo.y++" and "bar.yy" will
129     produce header files named "foo.h++" and "bar.hh" respectively, where
130     they would have previously produced header files named simply "foo.h"
131     and "bar.h".  This change offers better compatibility with 'bison -o'.
132
133 * Miscellaneous changes:
134
135   - Automake has a new option '--print-libdir' that prints the path of the
136     directory containing the Automake-provided scripts and data files.
137
138   - The 'dist' and 'dist-all' targets now can run compressors in parallel.
139
140   - Automake can now generate silenced rules for texinfo outputs.
141
142   - Some auxiliary files that are automatically distributed by Automake
143     (e.g., 'install-sh', or the 'depcomp' script for packages compiling
144     C sources) might now be listed in the DIST_COMMON variable in many
145     Makefile.in files, rather than in the top-level one.
146
147   - Messages of types warning or error from 'automake' and 'aclocal'
148     are now prefixed with the respective type, and presence of -Werror
149     is noted.
150
151   - Automake's early configure-time sanity check now tries to avoid
152     sleeping for a second, which slowed down cached configure runs
153     noticeably.  In that case, it will check back at the end of the
154     configure script to ensure that at least one second has passed, to
155     avoid time stamp issues with makefile rules rerunning autotools
156     programs.
157
158   - For programs and libraries, automake now detect EXTRA_foo_DEPENDENCIES
159     and adds them to the normal list of dependencies, but without
160     overwriting the foo_DEPENDENCIES variable, which is normally computed
161     by automake.
162
163   - The warnings in the category 'extra-portability' are now enabled by
164     '-Wall'.  In previous versions, one has to use '-Wextra-portability'
165     to enable them.
166
167 Bugs fixed in 1.11a:
168
169   - Various minor bugfixes for recent or long-standing bugs.
170
171 * Bugs introduced by 1.11:
172
173   - The AM_COND_IF macro also works if the shell expression for the
174     conditional is no longer valid for the condition.
175
176   - The automake-provided parallel testsuite harness does not fail anymore
177     with BSD make used in parallel mode when there are test scripts in a
178     subdirectory, like in:
179
180       TESTS = sub/foo.test sub/bar.test
181
182 * Long-standing bugs:
183
184   - Automake's own build system finally have a real "installcheck" target.
185
186   - Files listed with the AC_REQUIRE_AUX_FILE macro in configure.ac are
187     now automatically distributed also if the directory of the auxiliary
188     files coincides with the top-level directory.
189
190   - Automake now detects the presence of the '-d' flag in the various
191     '*YFLAGS' variables even when their definitions involve indirections
192     through other variables, such as in:
193       foo_opts = -d
194       AM_YFLAGS = $(foo_opts)
195
196   - Automake now complains if a '*YFLAGS' variable has any conditional
197     content, not only a conditional definition.
198
199   - Explicit enabling and/or disabling of Automake warning categories
200     through the '-W...' options now always takes precedence over the
201     implicit warning level implied by Automake strictness (foreign, gnu
202     or gnits), regardless of the order in which such strictness and
203     warning flags appear.  For example, a setting like:
204       AUTOMAKE_OPTIONS = -Wall --foreign
205     will cause the warnings in category 'portability' to be enabled, even
206     if those warnings are by default disabled in 'foreign' strictness.
207
208 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
209
210 New in 1.11.3:
211
212 * WARNING: Future backward-incompatibilities!
213
214   - The obsolescent AM_WITH_REGEX  macro has been deprecated, since the
215     GNU rx library has been decommissioned.
216
217   - The `lzma' compression format for distribution archives has been
218     deprecated in favor of `xz' and `lzip'.
219
220 * Miscellaneous changes:
221
222   - Automake's own build system is more silent by default, making use of
223     the 'silent-rules' option.
224
225   - The master copy of the `gnupload' script is now maintained in gnulib,
226     not in automake.
227
228   - The `missing' script doesn't try to wrap calls to `tar' anymore.
229
230   - "make dist" doesn't wrap `tar' invocations with the `missing' script
231     anymore.  Similarly, the obsolescent variable `$(AMTAR)' (which you
232     shouldn't be using BTW ;-) does not invoke the missing script anymore
233     to wrap tar, but simply invokes the `tar' program itself.
234
235   - "make dist" can now create lzip-compressed tarballs.
236
237   - In the Automake info documentation, the Top node and the nodes about
238     the invocation of the automake and aclocal programs have been renamed;
239     now, calling "info automake" will open the Top node, while calling
240     "info automake-invocation" and "info aclocal-invocation" will access
241     the nodes about the invocation of respectively automake and aclocal.
242
243   - Automake is now distributed as a gzip-compressed and an xz-compressed
244     tarball.  Previously, bzip2 was used instead of xz.
245
246   - The last relics of Python 1.5 support have been removed from the
247     AM_PATH_PYTHON macro.
248
249 Bugs fixed in 1.11.3:
250
251 * Long-standing bugs:
252
253   - The "deleted header file problem" for *.am files is avoided by stub
254     rules.  This allows `make' to trigger a rerun of `automake' also if
255     some previously needed `.am' file has been removed.
256
257   - The `silent-rules' option now generates working makefiles even
258     for the uncommon `make' implementations that do not support the
259     nested-variables extension to POSIX 2008.  For such `make'
260     implementations, whether a build is silent is determined at
261     configure time, and cannot be overridden at make time with
262     `make V=0' or `make V=1'.
263
264   - Vala support now works better in VPATH setups.
265
266 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
267
268 New in 1.11.2:
269
270 * Changes to aclocal:
271
272   - The `--acdir' option is deprecated.  Now you should use the new options
273     `--automake-acdir' and `--system-acdir' instead.
274
275   - The `ACLOCAL_PATH' environment variable is now interpreted as a
276     colon-separated list of additional directories to search after the
277     automake internal acdir (by default ${prefix}/share/aclocal-APIVERSION)
278     and before the system acdir (by default ${prefix}/share/aclocal).
279
280 * Miscellaneous changes:
281
282   - The Automake support for automatic de-ANSI-fication has been
283     deprecated.
284
285   - The `lzma' compression scheme and associated automake option `dist-lzma'
286     is obsoleted by `xz' and `dist-xz' due to upstream changes.
287
288   - You may adjust the compression options used in dist-xz and dist-bzip2.
289     The default is now merely -e for xz, but still -9 for bzip;  you may
290     specify a different level via the XZ_OPT and BZIP2 envvars respectively.
291     E.g., "make dist-xz XZ_OPT=-7" or "make dist-bzip2 BZIP2=-5"
292
293   - The `compile' script now converts some options for MSVC for a better
294     user experience.  Similarly, the new `ar-lib' script wraps Microsoft lib.
295
296   - The py-compile script now accepts empty arguments passed to the options
297     `--destdir' and `--basedir', and complains about unrecognized options.
298     Moreover, a non-option argument or a special `--' argument terminates
299     the list of options.
300
301   - A developer that needs to pass specific flags to configure at "make
302     distcheck" time can now, and indeed is advised to, do so by defining
303     the developer-reserved makefile variable AM_DISTCHECK_CONFIGURE_FLAGS,
304     instead of the old DISTCHECK_CONFIGURE_FLAGS.
305     The DISTCHECK_CONFIGURE_FLAGS variable should now be reserved for the
306     user; still, the old Makefile.am files that used to define it will
307     still continue to work as before.
308
309   - New macro AM_PROG_AR that looks for an archiver and wraps it in the new
310     'ar-lib' auxiliary script if the selected archiver is Microsoft lib.
311     This new macro is required for LIBRARIES and LTLIBRARIES when automake
312     is run with -Wextra-portability and -Werror.
313
314   - When using DejaGnu-based testsuites, the user can extend the `site.exp'
315     file generated by automake-provided rules by defining the special make
316     variable `$(EXTRA_DEJAGNU_SITE_CONFIG)'.
317
318   - The `install-info' rule can now be instructed not to create/update
319     the `${infodir}/dir' file, by exporting the new environment variable
320     `AM_UPDATE_INFO_DIR' to the value "no".
321
322 Bugs fixed in 1.11.2:
323
324 * Bugs introduced by 1.11.2:
325
326   - Automake now correctly recognizes the prefix/primary combination
327    `pkglibexec_SCRIPTS' as valid.
328
329 * Bugs introduced by 1.11:
330
331   - The parallel-tests driver no longer produces erroneous results with
332     Tru64/OSF 5.1 sh upon unreadable log files.
333
334   - The `parallel-tests' test driver does not report spurious successes
335     when used with concurrent FreeBSD make (e.g., "make check -j3").
336
337   - When the parallel-tests driver is in use, automake now explicitly
338     rejects invalid entries and conditional contents in TEST_EXTENSIONS,
339     instead of issuing confusing and apparently unrelated error messages
340     (e.g., "non-POSIX variable name", "bad characters in variable name",
341     or "redefinition of TEST_EXTENSIONS), or even, in some situations,
342     silently producing broken `Makefile.in' files.
343
344   - The `silent-rules' option now truly silences all compile rules, even
345     when dependency tracking is disabled.  Also, when `silent-rules' is
346     not used, `make' output no longer contains spurious backslash-only
347     lines, thus once again matching what Automake did before 1.11.
348
349   - The AM_COND_IF macro also works if the shell expression for the
350     conditional is no longer valid for the condition.
351
352 * Long-standing bugs:
353
354   - The order of Yacc and Lex flags is fixed to be consistent with other
355     languages: $(AM_YFLAGS) comes before $(YFLAGS), and $(AM_LFLAGS) before
356     $(LFLAGS), so that the user variables override the developer variables.
357
358   - "make distcheck" now correctly complains also when "make uninstall"
359     leaves one and only one file installed in $(prefix).
360
361   - A "make uninstall" issued before a "make install", or after a mere
362     "make install-data" or a mere "make install-exec" does not spuriously
363     fail anymore.
364
365   - Automake now warns about more primary/directory invalid combinations,
366     such as "doc_LIBRARIES" or "pkglib_PROGRAMS".
367
368   - Rules generated by Automake now try harder to not change any files when
369     `make -n' is invoked.  Fixes include compilation of Emacs Lisp, Vala, or
370     Yacc source files and the rule to update config.h.
371
372   - Several scripts and the parallel-tests testsuite driver now exit with
373     the right exit status upon receiving a signal.
374
375   - A per-Makefile.am setting of -Werror does not erroneously carry over
376     to the handling of other Makefile.am files.
377
378   - The code for automatic dependency tracking works around a Solaris
379     make bug triggered by sources containing repeated slashes when the
380     `subdir-objects' option was used.
381
382   - The makedepend and hp depmodes now work better with VPATH builds.
383
384   - Java sources specified with check_JAVA are no longer compiled for
385     "make all", but only for "make check".
386
387   - An usage like "java_JAVA = foo.java" will now cause Automake to warn
388     and error out if `javadir' is undefined, instead of silently producing
389     a broken Makefile.in.
390
391   - aclocal and automake now honour the configure-time definitions of
392     AUTOCONF and AUTOM4TE when they spawn autoconf or autom4te processes.
393
394   - The `install-info' recipe no longer tries to guess whether the
395     `install-info' program is from Debian or from GNU, and adaptively
396     change its behaviour; this has proven to be frail and easy to
397     regress.
398
399 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
400
401 Bugs fixed in 1.11.1:
402
403   - Lots of minor bugfixes.
404
405 * Bugs introduced by 1.11:
406
407   - The `parallel-tests' test driver works around a GNU make 3.80 bug with
408     trailing white space in the test list (`TESTS = foo $(EMPTY)').
409
410 * Long standing bugs:
411
412   - On Darwin 9, `pythondir' and `pyexecdir' pointed below `/Library/Python'
413     even if the `--prefix' argument pointed outside of a system directory.
414     AM_PATH_PYTHON has been fixed to ignore the value returned from python's
415     `get_python_lib' function if it points outside the configured prefix,
416     unless the `--prefix' argument was either `/usr' or below `/System'.
417
418   - The testsuite does not try to change the mode of `ltmain.sh' files from
419     a Libtool installation (symlinked to test directories) any more.
420
421   - AM_PROG_GCJ uses AC_CHECK_TOOLS to look for `gcj' now, so that prefixed
422     tools are preferred in a cross-compile setup.
423
424   - The distribution is tarred up with mode 755 now by the `dist*' targets.
425     This fixes a race condition where untrusted users could modify files
426     in the $(PACKAGE)-$(VERSION) distdir before packing if the toplevel
427     build directory was world-searchable.  This is CVE-2009-4029.
428
429 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
430
431 New in 1.11:
432
433 * Version requirements:
434
435   - Autoconf 2.62 or greater is required.
436
437 * Changes to aclocal:
438
439   - The autoconf version check implemented by aclocal in aclocal.m4
440     (and new in Automake 1.10) is degraded to a warning.  This helps
441     in the common case where the Autoconf versions used are compatible.
442
443 * Changes to automake:
444
445   - The automake program can run multiple threads for creating most
446     Makefile.in files concurrently, if at least Perl 5.7.2 is available
447     with interpreter-based threads enabled.  Set the environment variable
448     AUTOMAKE_JOBS to the maximum number of threads to use, in order to
449     enable this experimental feature.
450
451 * Changes to Libtool support:
452
453   - Libtool generic flags are now passed to the install and uninstall
454     modes as well.
455
456   - distcheck works with Libtool 2.x even when LT_OUTPUT is used, as
457     config.lt is removed correctly now.
458
459 * Languages changes:
460
461   - subdir-object mode works now with Fortran (F77, FC, preprocessed
462     Fortran, and Ratfor).
463
464   - For files with extension .f90, .f95, .f03, or .f08, the flag
465     $(FCFLAGS_f[09]x) computed by AC_FC_SRCEXT is now used in compile rules.
466
467   - Files with extension .sx are also treated as preprocessed assembler.
468
469   - The default source file extension (.c) can be overridden with
470     AM_DEFAULT_SOURCE_EXT now.
471
472   - Python 3.0 is supported now, Python releases prior to 2.0 are no
473     longer supported.
474
475   - AM_PATH_PYTHON honors python's idea about the site directory.
476
477   - There is initial support for the Vala programming language, when using
478     Vala 0.7.0 or later.
479
480 * Miscellaneous changes:
481
482   - Automake development is done in a git repository on Savannah now, see
483
484       http://git.sv.gnu.org/gitweb/?p=automake.git
485
486     A read-only CVS mirror is provided at
487
488       cvs -d :pserver:anonymous@pserver.git.sv.gnu.org:/automake.git \
489           checkout -d automake HEAD
490
491   - "make dist" can now create xz-compressed tarballs,
492     as well as (deprecated?) lzma-compressed tarballs.
493
494   - `automake --add-missing' will by default install the GPLv3 file as
495     COPYING if it is missing.  It will also warn that the license file
496     should be added to source control.  Note that Automake will never
497     overwrite an existing COPYING file, even when the `--force-missing'
498     option is used.
499
500   - The manual is now distributed under the terms of the GNU FDL 1.3.
501
502   - Automake ships and installs man pages for automake and aclocal now.
503
504   - New shorthand `$(pkglibexecdir)' for `$(libexecdir)/@PACKAGE@'.
505
506   - install-sh supports -C, which does not update the installed file
507     (and its time stamps) if the contents did not change.
508
509   - The `gnupload' script has been revamped.
510
511   - The `depcomp' and `compile' scripts now work with MSVC under MSYS.
512
513   - The targets `install' and `uninstall' are more efficient now, in that
514     for example multiple files from one Automake variable such as
515     `bin_SCRIPTS' are copied in one `install' (or `libtool --mode=install')
516     invocation if they do not have to be renamed.
517
518     Both install and uninstall may sometimes enter (`cd' into) the target
519     installation directory now, when no build-local scripts are used.
520
521     Both install and uninstall do not fail anymore but do nothing if an
522     installation directory variable like `bindir' is set to the empty string.
523
524     For built-in rules, `make install' now fails reliably if installation
525     of a file failed.  Conversely, `make uninstall' even succeeds when
526     issued multiple times.
527
528     These changes may need some adjustments from users:  For example,
529     some `install' programs refuse to install multiple copies of the
530     same file in one invocation, so you may need to remove duplicate
531     entries from file lists.
532
533     Also, within one set of files, say, nobase_data_DATA, the order of
534     installation may be changed, or even unstable among different hosts,
535     due to the use of associative arrays in awk.  The increased use of
536     awk matches a similar move in Autoconf to provide for better scaling.
537
538     Further, most undocumented per-rule install command variables such as
539     binSCRIPT_INSTALL have been removed because they are not needed any
540     more.  Packages which use them should be using the appropriate one of
541     INSTALL_{DATA,PROGRAM,SCRIPT} or their install_sh_{DATA,PROGRAM,SCRIPT}
542     counterpart, depending on the type of files and the need for automatic
543     target directory creation.
544
545   - The "deleted header file problem" for *.m4 files is avoided by
546     stub rules.  This allows `make' to trigger a rerun of `aclocal'
547     also if some previously needed macro file has been removed.
548
549   - Rebuild rules now also work for a removed `subdir/Makefile.in' in
550     an otherwise up to date tree.
551
552   - The `color-tests' option causes colored test result output on terminals.
553
554   - The `parallel-tests' option enables a new test driver that allows for
555     parallel test execution, inter-test dependencies, lazy test execution
556     for unit-testing, re-testing only failed tests, and formatted result output
557     as RST (reStructuredText) and HTML.  Enabling this option may require some
558     changes to your test suite setup; see the manual for details.
559
560   - The `silent-rules' option enables Linux kernel-style silent build output.
561     This option requires the widely supported but non-POSIX `make' feature
562     of recursive variable expansion, so do not use it if your package needs
563     to build with `make' implementations that do not support it.
564
565     To enable less verbose build output, the developer has to use the Automake
566     option `silent-rules' in `AM_INIT_AUTOMAKE', or call the `AM_SILENT_RULES'
567     macro.  The user may then set the default verbosity by passing the
568     `--enable-silent-rules' option to `configure'.  At `make' run time, this
569     default may be overridden using `make V=0' for less verbose, and `make V=1'
570     for backward-compatible verbose output.
571
572   - New prefix `notrans_' for manpages which should not be transformed
573     by --program-transform.
574
575   - New macro AM_COND_IF for conditional evaluation and conditional
576     config files.
577
578   - For AC_CONFIG_LINKS, if source and destination are equal, do not
579     remove the file in a non-VPATH build.  Such setups work with Autoconf
580     2.62 or newer.
581
582   - AM_MAINTAINER_MODE now allows for an optional argument specifying
583     the default setting.
584
585   - AM_SUBST_NOTMAKE may prevent substitution of AC_SUBSTed variables,
586     useful especially for multi-line values.
587
588   - Automake's early configure-time sanity check now diagnoses an
589     unsafe absolute source directory name and makes configure fail.
590
591   - The Automake macros and rules cope better with whitespace in the
592     current directory name, as long as the relative path to `configure'
593     does not contain whitespace.  To this end, the values of `$(MISSING)'
594     and `$(install_sh)' may contain suitable quoting, and their expansion
595     might need `eval'uation if used outside of a makefile.  These
596     undocumented variables may be used in several documented macros such
597     as $(AUTOCONF) or $(MAKEINFO).
598
599 Bugs fixed in 1.11:
600
601 * Long-standing bugs:
602
603   - Fix aix dependency tracking for libtool objects.
604
605   - Work around AIX sh quoting issue in AC_PROG_CC_C_O, leading to
606     unnecessary use of the `compile' script.
607
608   - For nobase_*_LTLIBRARIES with nonempty directory components, the
609     correct `-rpath' argument is used now.
610
611   - `config.status --file=Makefile depfiles' now also works with the
612     extra quoting used internally by Autoconf 2.62 and newer
613     (it used to work only without the `--file=' bit).
614
615   - The `missing' script works better with versioned tool names.
616
617   - Semantics for `missing help2man' have been revamped:
618
619     Previously, if `help2man' was not present, `missing help2man' would have
620     the following semantics: if some man page was out of date but present, then
621     a warning would be printed, but the exit status was 0.  If the man page was
622     not present at all, then `missing' would create a replacement man page
623     containing an error message, and exit with a status of 2.  This does not play
624     well with `make': the next run will see this particular man page as being up
625     to date, and will only error out on the next generated man page, if any;
626     repeat until all pages are done.  This was not desirable.
627
628     These are the new semantics: if some man page is not present, and help2man
629     is not either, then `missing' will warn and generate the replacement page
630     containing the error message, but exit successfully.  However, `make dist'
631     will ensure that no such bogus man pages are packaged into a tarball.
632
633   - Targets provided by automake behave better with `make -n', in that they
634     take care not to create files.
635
636   - `config.status Makefile... depfiles' works fine again in the presence of
637     disabled dependency tracking.
638
639   - The default no-op recursive rules for these targets also work with BSD make
640     now: html, install-html, install-dvi, install-pdf, install-pdf, install-info.
641
642   - `make distcheck' works also when both a directory and some file below it
643     have been added to a distribution variable, such as EXTRA_DIST or *_SOURCES.
644
645   - Texinfo dvi, ps, pdf, and html output files are not removed upon
646     `make mostlyclean' any more; only the LaTeX by-products are.
647
648   - Renamed objects also work with the `subdir-objects' option and
649     source file languages which Automake does not know itself.
650
651   - `automake' now correctly complains about variable assignments which are
652     preceded by a comment, extend over multiple lines with backslash-escaped
653     newlines, and end in a comment sign.  Previous versions would silently
654     and wrongly ignore such assignments completely.
655
656 * Bugs introduced by 1.10:
657
658   - Fix output of dummy dependency files in presence of post-processed
659     Makefile.in's again, but also cope with long lines.
660
661   - $(EXEEXT) is automatically appended to filenames of XFAIL_TESTS
662     that have been declared as programs in the same Makefile.
663     This is for consistency with the analogous change to TESTS in 1.10.
664
665   - Fix order of standard includes to again be `-I. -I$(srcdir)',
666     followed by directories containing config headers.
667
668 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
669
670 New in 1.10:
671
672 * Version requirements:
673
674   - Autoconf 2.60 or greater is required.
675
676   - Perl 5.6 or greater is required.
677
678 * Changes to aclocal:
679
680   - aclocal now also supports -Wmumble and -Wno-mumble options.
681
682   - `dirlist' entries (for the aclocal search path) may use shell
683     wildcards such as `*', `?', or `[...]'.
684
685   - aclocal supports an --install option that will cause system-wide
686     third-party macros to be installed in the local directory
687     specified with the first -I flag.  This option also uses #serial
688     lines in M4 files to upgrade local macros.
689
690     The new aclocal options --dry-run and --diff help to review changes
691     before they are installed.
692
693   - aclocal now outputs an autoconf version check in aclocal.m4 in
694     projects using automake.
695
696     For a few years, automake and aclocal have been calling autoconf
697     (or its underlying engine autom4te) to accurately retrieve the
698     data they need from configure.ac and its siblings.  Doing so can
699     only work if all autotools use the same version of autoconf.  For
700     instance a Makefile.in generated by automake for one version of
701     autoconf may stop working if configure is regenerated with another
702     version of autoconf, and vice versa.
703
704     This new version check ensures that the whole build system has
705     been generated using the same autoconf version.
706
707 * Support for new Autoconf macros:
708
709   - The new AC_REQUIRE_AUX_FILE Autoconf macro is supported.
710
711   - If `subdir-objects' is set, and AC_CONFIG_LIBOBJ_DIR is specified,
712     $(LIBOBJS), $(LTLIBOBJS), $(ALLOCA), and $(LTALLOCA) can be used
713     in different directories.  However, only one instance of such a
714     library objects directory is supported.
715
716 * Change to Libtool support:
717
718   - Libtool generic flags (those that go before the --mode=MODE option)
719     can be specified using AM_LIBTOOLFLAGS and target_LIBTOOLFLAGS.
720
721 * Yacc and Lex changes:
722
723   - The rebuild rules for distributed Yacc and Lex output will avoid
724     overwriting existing files if AM_MAINTAINER_MODE and maintainer-mode
725     is not enabled.
726
727   - ylwrap is now always used for lex and yacc source files,
728     regardless of whether there is more than one source per directory.
729
730 * Languages changes:
731
732   - Preprocessed assembler (*.S) compilation now honors CPPFLAGS,
733     AM_CPPFLAGS and per-target _CPPFLAGS, and supports dependency
734     tracking, unlike non-preprocessed assembler (*.s).
735
736   - subdir-object mode works now with Assembler.  Automake assumes
737     that the compiler understands `-c -o'.
738
739   - Preprocessed assembler (*.S) compilation now also honors
740     $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES).
741
742   - Improved support for Objective C:
743     - Autoconf's new AC_PROG_OBJC will enable automatic dependency tracking.
744     - A new section of the manual documents the support.
745
746   - New support for Unified Parallel C:
747     - AM_PROG_UPC looks for a UPC compiler.
748     - A new section of the manual documents the support.
749
750   - Per-target flags are now correctly handled in link rules.
751
752     For instance maude_CFLAGS correctly overrides AM_CFLAGS; likewise
753     for maude_LDFLAGS and AM_LDFLAGS.  Previous versions bogusly
754     preferred AM_CFLAGS over maude_CFLAGS while linking, and they
755     used both AM_LDFLAGS and maude_LDFLAGS on the same link command.
756
757     The fix for compiler flags (i.e., using maude_CFLAGS instead of
758     AM_CFLAGS) should not hurt any package since that is how _CFLAGS
759     is expected to work (and actually works during compilation).
760
761     However using maude_LDFLAGS "instead of" AM_LDFLAGS rather than
762     "in addition to" breaks backward compatibility with older versions.
763     If your package used both variables, as in
764
765       AM_LDFLAGS = common flags
766       bin_PROGRAMS = a b c
767       a_LDFLAGS = more flags
768       ...
769
770     and assumed *_LDFLAGS would sum up, you should rewrite it as
771
772       AM_LDFLAGS = common flags
773       bin_PROGRAMS = a b c
774       a_LDFLAGS = $(AM_LDFLAGS) more flags
775       ...
776
777     This new behavior of *_LDFLAGS is more coherent with other
778     per-target variables, and the way *_LDFLAGS variables were
779     considered internally.
780
781 * New installation targets:
782
783   - New targets mandated by GNU Coding Standards:
784       install-dvi
785       install-html
786       install-ps
787       install-pdf
788     By default they will only install Texinfo manuals.
789     You can customize them with *-local variants:
790       install-dvi-local
791       install-html-local
792       install-ps-local
793       install-pdf-local
794
795   - The undocumented recursive target `uninstall-info' no longer exists.
796     (`uninstall' is in charge of removing all possible documentation
797     flavors, including optional formats such as dvi, ps, or info even
798     when `no-installinfo' is used.)
799
800 * Miscellaneous changes:
801
802   - Automake no longer complains if input files for AC_CONFIG_FILES
803     are specified using shell variables.
804
805   - clean, distribution, or rebuild rules are normally disabled for
806     inputs and outputs of AC_CONFIG_FILES, AC_CONFIG_HEADERS, and
807     AC_CONFIG_LINK specified using shell variables.  However, if these
808     variables are used as ${VAR}, and AC_SUBSTed, then Automake will
809     be able to output rules anyway.
810     (See the Automake documentation for AC_CONFIG_FILES.)
811
812   - $(EXEEXT) is automatically appended to filenames of TESTS
813     that have been declared as programs in the same Makefile.
814     This is mostly useful when some check_PROGRAMS are listed in TESTS.
815
816   - `-Wportability' has finally been turned on by default for `gnu' and
817     `gnits' strictness.  This means, automake will complain about %-rules
818     or $(GNU Make functions) unless you switch to `foreign' strictness or
819     use `-Wno-portability'.
820
821   - Automake now uses AC_PROG_MKDIR_P (new in Autoconf 2.60), and uses
822     $(MKDIR_P) instead of $(mkdir_p) to create directories.  The
823     $(mkdir_p) variable is still defined (to the same value as
824     $(MKDIR_P)) but should be considered obsolete.  If you are using
825     $(mkdir_p) in some of your rules, please plan to update them to
826     $(MKDIR_P) at some point.
827
828   - AM_C_PROTOTYPES and ansi2knr are now documented as being obsolete.
829     They still work in this release, but may be withdrawn in a future one.
830
831   - Inline compilation rules for gcc3-style dependency tracking are
832     more readable.
833
834   - Automake installs a "Hello World!" example package in $(docdir).
835     This example is used throughout the new "Autotools Introduction"
836     chapter of the manual.
837
838 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
839
840 New in 1.9:
841
842 * Makefile.in bloat reduction:
843
844   - Inference rules are used to compile sources in subdirectories when
845     the `subdir-objects' option is used and no per-target flags are
846     used.  This should reduce the size of some projects a lot, because
847     Automake used to output an explicit rule for each such object in
848     the past.
849
850   - Automake no longer outputs three rules (.o, .obj, .lo) for each
851     object that must be built with explicit rules.  It just outputs
852     the rules required to build the kind of object considered: either
853     the two .o and .obj rules for usual objects, or the .lo rule for
854     libtool objects.
855
856 * Change to Libtool support:
857
858   - Libtool tags are used with libtool versions that support them.
859     (I.e., with Libtool 1.5 or greater.)
860
861   - Automake is now able to handle setups where a libtool library is
862     conditionally installed in different directories, as in
863
864       if COND
865         lib_LTLIBRARIES = liba.la
866       else
867         pkglib_LTLIBRARIES = liba.la
868       endif
869       liba_la_SOURCES = ...
870
871 * Changes to aclocal:
872
873   - aclocal now ensures that AC_DEFUNs and AU_DEFUNs it discovers are
874     really evaluated, before it decides to include them in aclocal.m4.
875     This solves nasty problems with conditional redefinitions of
876     Autoconf macros in /usr/share/aclocal/*.m4 files causing extraneous
877     *.m4 files to be included in any project using these macros.
878     (Calls to AC_PROG_EGREP causing libtool.m4 to be included is the
879     most famous instance of this bug.)
880
881   - Do not complain about missing conditionally AC_REQUIREd macros
882     that are not actually used.  In 1.8.x aclocal would correctly
883     determine which of these macros were really needed (and include
884     only these in the package); unfortunately it would also require
885     all of them to be present in order to run.  This created
886     situations were aclocal would not work on a tarball distributing
887     all the macros it uses.  For instance running aclocal on a project
888     containing only the subset of the Gettext macros in use by the
889     project did not work, because gettext conditionally requires other
890     macros.
891
892 * Portability improvements:
893
894   - Tar format can be chosen with the new options tar-v7, tar-ustar, and
895     tar-pax.  The new option filename-length-max=99 helps diagnosing
896     filenames that are too long for tar-v7.  (PR/414)
897
898   - Variables aumented with `+=' are now automatically flattened (i.e.,
899     trailing backslashes removed) and then wrapped around 80 colummns
900     (adding trailing backslashes).  In previous versions, a long series
901     of
902       VAR += value1
903       VAR += value2
904       VAR += value3
905       ...
906     would result in a single-line definition of VAR that could possibly
907     exceed the maximum line length of some make implementations.
908
909     Non-augmented variables are still output as they are defined in
910     the Makefile.am.
911
912 * Miscellaneous:
913
914   - Support Fortran 90/95 with the new "fc" and "ppfc" languages.
915     Works the same as the old Fortran 77 implementation; just replace
916     F77 with FC everywhere (exception: FFLAGS becomes FCFLAGS).
917     Requires a version of autoconf which provides AC_PROG_FC (>=2.59).
918
919   - Support for conditional _LISP.
920
921   - Support for conditional -hook and -local rules (PR/428).
922
923   - Diagnose AC_CONFIG_AUX_DIR calls following AM_INIT_AUTOMAKE. (PR/49)
924
925   - Automake will not write any Makefile.ins after the first error it
926     encounters.  The previous Makefile.ins (if any) will be left in
927     place.  (Warnings will not prevent output, but remember they can
928     be turned into errors with -Werror.)
929
930   - The restriction that SUBDIRS must contain direct children is gone.
931     Do not abuse.
932
933   - The manual tells more about SUBDIRS vs. DIST_SUBDIRS.
934     It also gives an example of nested packages using AC_CONFIG_SUBDIRS.
935
936 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
937
938 Bugs fixed in 1.8.5:
939
940 * Long-standing bugs:
941
942   - Define DIST_SUBDIRS even when the `no-dist' or `cygnus' options are used
943     so that `make distclean' and `make maintainer-clean' can work.
944
945   - Define AR and ARFLAGS even when only EXTRA_LIBRARIES are defined.
946
947   - Fix many rules to please FreeBSD make, which runs commands with `sh -e'.
948
949   - Polish diagnostic when no input file is found.
950
951 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
952
953 Bugs fixed in 1.8.4:
954
955 * Long-standing bugs:
956
957   - Fix AM_PATH_PYTHON to correctly display $PYTHON when it has been
958     overridden by the user.
959
960   - Honor PATH_SEPARATOR in various places of the Automake package, for
961     the sake of OS/2.
962
963   - Adjust dependency tracking mode detection to ICC 8.0's new output.
964     (PR/416)
965
966   - Fix install-sh so it can install the `mv' binary... using `mv'.
967
968   - Fix tru64 dependency tracking for libtool objects.
969
970   - Work around Exuberant Ctags when creating a TAGS files in a directory
971     without files to scan but with subdirectories to include.
972
973 * Bugs introduced by 1.8:
974
975   - Fix an "internal error" when @LIBOBJS@ is used in a variable that is
976     not defined in the same conditions as the _LDADD that uses it.
977
978   - Do not warn when JAVAROOT is overridden, this is legitimate.
979
980 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
981
982 Bugs fixed in 1.8.3:
983
984 * Long-standing bugs:
985
986   - Quote filenames in installation rules, in case $DESTDIR, $prefix,
987     or any of the other *dir variables contain a space.
988
989     Please note that Automake does not and cannot support spaces in
990     filenames that are involved during the build.  This change affects
991     only installation paths, so that `make install' does not bomb out
992     in packages configured with
993       ./configure --prefix '/c/Program Files'
994
995   - Fix the depfiles output so it works with GNU sed (<4.1) even when
996     POSIXLY_CORRECT is set.
997
998   - Do not AC_SUBST(LIBOBJS) in AM_WITH_REGEX.  This macro was unusable
999     since Autoconf 2.54, which defines LIBOBJS itself.
1000
1001   - Fix a potential (but unlikely) race condition in parallel elisp
1002     builds.  (Introduced in 1.7.3.)
1003
1004   - Do not assume that users override _DEPENDENCIES in all conditions
1005     where Automake will try to define them.
1006
1007   - Do not use `mkdir -p' in mkinstalldirs, unless this is GNU mkdir.
1008     Solaris 8's `mkdir -p' is not thread-safe and can break parallel
1009     builds.
1010
1011     This fix also affects the $(mkdir_p) variable defined since
1012     Automake 1.8.  It will be set to `mkdir -p' only if mkdir is GNU
1013     mkdir, and to `mkinstalldirs' or `install-sh -d' otherwise.
1014
1015   - Secure temporary directory creation in `make distcheck'. (PR/413)
1016
1017   - Do not generate two build rules for `parser.h' when the
1018     parser appears in two different conditionals.
1019
1020   - Work around a Solaris 8 /bin/sh bug in the test for dependency
1021     checking.  Usually ./configure will not pick this shell; so this
1022     fix only helps cases where the shell is forced to /bin/sh.
1023
1024 * Bugs introduced by 1.8:
1025
1026   - In some situations (hand-written `m4_include's), aclocal would
1027     call the `File::Spec->rel2abs' method, which was only introduced
1028     in Perl 5.6.  This new version reestablish support Perl 5.005.
1029
1030     It is likely that the next major Automake releases will require at
1031     least Perl 5.6.  Consider upgrading your development environment
1032     if you are still using the five-year-old Perl 5.005.
1033
1034   - Automake would sometimes fail to define rules for targets listed
1035     in variables defined in multiple conditions.  For instance on
1036       if C1
1037         bin_PROGRAMS = a
1038       else
1039         bin_PROGRAMS = b
1040       endif
1041     it would define only the `a.$(OBJEXT): a.c' rule and omit the
1042     `b.$(OBJEXT): b.c' rule.
1043
1044 * New sections in manual:
1045
1046   - Third-Party Makefiles: how to interface third party Makefiles.
1047   - Upgrading: upgrading packages to newer Automake versions.
1048   - Multiple Outputs: handling tools that produce many outputs.
1049
1050 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1051
1052 Bug fixed in 1.8.2:
1053
1054 * A (well known) portability bug slipped in the changes made to
1055   install-sh in Automake 1.8.1.  The broken install-sh would refuse to
1056   install anything on Tru64.
1057
1058 * Fix install rules for conditionally built python files.  (This never
1059   really worked.)
1060
1061 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1062
1063 Bug fixed in 1.8.1:
1064
1065 * Bugs introduced by 1.8:
1066
1067   - Fix Config.pm import error with old Perl versions (at least
1068     5.005_03).  One symptom is that aclocal could not find its macro
1069     directory.
1070
1071   - Automake 1.8 used `mkdir -m 0755 -p --' to ensure that directories
1072     created by `make install' are always world readable, even if the
1073     installer happens to have an overly restrictive umask (e.g. 077).
1074     This was a mistake and has been reverted.  There are at least two
1075     reasons why we must not use `-m 0755':
1076       - it causes special bits like SGID to be ignored,
1077       - it may be too restrictive (some setups expect 775 directories).
1078
1079   - Fix aclocal to honor definitions located in files which have been
1080     m4_included manually.  aclocal 1.8 had been updated to check
1081     m4_included files for new requirements, but forgot that these
1082     m4_included files can also provide new definitions.
1083
1084     Note that if you have such a setup, we recommend you get rid of
1085     it.  In the past, there was a reason to m4_include files manually:
1086     aclocal used to duplicate entire M4 files into aclocal.m4, even
1087     files that were distributed.  Some packages were therefore
1088     m4_including the distributed file directly, and playing some
1089     tricks to ensure aclocal would not copy that file to aclocal.m4,
1090     in order to limit the amount of duplication.  Since aclocal 1.8.x
1091     will precisely output m4_includes for local M4 files, we recommend
1092     that you clean up your setup, removing all manual m4_includes and
1093     letting aclocal output them.
1094
1095   - Output detailed menus in the Info version if the Automake manual,
1096     so that Emacs can locate the indexes.
1097
1098   - configure.ac and configure were listed twice in DIST_COMMON (an
1099     internal variable where Automake lists configury files to
1100     distribute).  This was harmless, but unaesthetic.
1101
1102   - Use `chmod a-w' instead of `chmod -w' as the latter honors umask.
1103     This was an issue only in the Automake package itself, not in
1104     its output.
1105
1106   - Automake assumed that all AC_CONFIG_LINKS arguments had the form
1107     DEST:SRC.  This was wrong, as some packages do
1108     AC_CONFIG_LINKS($computedlinks).  This version no longer abort in
1109     that situation.
1110
1111   - Contrary to mkinstalldirs, $(mkdir_p) was expecting exactly one
1112     argument.  This caused two kinds of failures:
1113       - Rules installing data in a conditionally defined directory
1114         failed when that directory was undefined.  In this case no
1115         argument was supplied.
1116       - `make installdirs' failed, because several directories were
1117         passed to $(mkdir_p).  This was an issue only on platform
1118         were $(mkdir_p) is implemented with `install-sh -d'.
1119     $(mkdir_p) as been changed to accept 0 or more arguments, as
1120     mkinstalldirs did.
1121
1122 * Long-standing bugs:
1123
1124   - Fix an unexpected diagnostic occurring when users attempt
1125     to override some internal variables that Automake appends to.
1126
1127   - aclocal now scans configure.ac for macro definitions (PR/319).
1128
1129   - Fix a portability issue with OSF1/Tru64 Make.  If a directory
1130     distributes files which are outside itself (this usually occurs
1131     when using AC_CONFIG_AUX_DIR([../dir]) to use auxiliary files
1132     from a parent package), then `make distcheck' fails due to an
1133     optimization performed by OSF1/Tru64 Make in its VPATH handling.
1134     (tests/subpkg2.test failure)
1135
1136   - Fix another portability issue with Sun and OSF1/Tru64 Make.
1137     In a VPATH-build configuration, `make install' would install
1138     nobase_ files to wrong locations.
1139
1140   - Fix a Perl `uninitialized value' diagnostic occurring when
1141     automake complains that a Texinfo file does not have a
1142     @setfilename statement.
1143
1144   - Erase config.status.lineno during `make distclean'.  This file
1145     can be created by config.status.  Automake already knew about
1146     configure.lineno, but forgot config.status.lineno.
1147
1148   - Distribute all files, even those which are built and installed
1149     conditionally.  This change affects files listed in conditionally
1150     defined *_HEADERS and *_PYTHON variable (unless they are nodist_*)
1151     as well as those listed in conditionally defined dist_*_DATA,
1152     dist_*_JAVA, dist_*_LISP, and dist_*_SCRIPTS variables.
1153
1154   - Fix AM_PATH_LISPDIR to avoid \? in sed regular expressions; it
1155     doesn't conform to POSIX.
1156
1157   - Normalize help strings for configure variables and options added
1158     by Automake macros.
1159
1160 * Anticipation:
1161
1162   - Check for python2.4 in AM_PATH_PYTHON.
1163
1164 * Spurious failures in test suite:
1165
1166   - tests/libtool5.test, tests/ltcond.test, tests/ltcond2.test,
1167     tests/ltconv.test: fix failures with CVS Libtool.
1168   - tests/aclocal6.test: fix failure if autom4te.cache is disabled.
1169   - tests/txinfo24.test, tests/txinfo25.test, tests/txinfo28.test:
1170     fix failures with old Texinfo versions.
1171
1172 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1173
1174 New in 1.8:
1175
1176 * Meta-News
1177
1178   - The NEWS file is more verbose.
1179
1180 * Requirements
1181
1182   - Autoconf 2.58 or greater is required.
1183
1184 * New features
1185
1186   - Default source file names in the absence of a _SOURCES declaration
1187     are made by removing any target extension before appending `.c', so
1188     to make the libtool module `foo.la' from `foo.c', you only need to
1189     do this:
1190
1191         lib_LTLIBRARIES = foo.la
1192         foo_la_LDFLAGS  = -module
1193
1194     For backward compatibility, foo_la.c will be used instead of
1195     foo.c if this file exists or is the explicit target of a rule.
1196     However -Wobsolete will warn about this deprecated naming.
1197
1198   - AR's `cru' flags are now set in a global ARFLAGS variable instead
1199     of being hard-coded in each $(AR) invocation, so they can be
1200     substituted from configure.ac.  This has been requested by people
1201     dealing with non-POSIX ar implementations.
1202
1203   - New warning option: -Woverride.  This will warn about any user
1204     target or variable definitions which override Automake
1205     definitions.
1206
1207   - Texinfo rules back up and restore info files when makeinfo fails.
1208
1209   - Texinfo rules now support the `html' target.
1210     Running this requires Texinfo 4.0 or greater.
1211
1212     `html' is a new recursive target, so if your package mixes
1213     hand-crafted `Makefile.in's with Automake-generated
1214     `Makefile.in's, you should adjust the former to support (or
1215     ignore) this target so that `make html' recurses successfully.  If
1216     you had a custom `html' rule in your `Makefile.am', it's better to
1217     rename it as `html-local', otherwise your rule will override
1218     Automake's new rule (you can check that by running `automake
1219     -Woverride') and that will stop the recursion to subdirectories.
1220
1221     Last but not least, this `html' rule is declared PHONY, even when
1222     overridden.  Fortunately, it appears that few packages use a
1223     non-PHONY `html' rule.
1224
1225   - Any file which is m4_included from configure.ac will appear as a
1226     configure and Makefile.in dependency, and will be automatically
1227     distributed.
1228
1229   - The rules for rebuilding Makefiles and Makefile.ins will now
1230     rebuild all Makefiles and all Makefile.ins at once when one of
1231     configure's dependencies has changed.  This is considerably faster
1232     than previous implementations, where config.status and automake
1233     were run separately in each directory (this still happens when you
1234     change a Makefile.am locally, without touching configure.ac or
1235     friends).  Doing this also solves a longstanding issue: these
1236     rebuild rules failed to work when adding new directories to the
1237     tree, forcing you to run automake manually.
1238
1239   - For similar reasons, the rules to rebuild configure,
1240     config.status, and aclocal.m4 are now defined in all directories.
1241     Note that if you were using the CONFIG_STATUS_DEPENDENCIES and
1242     CONFIGURE_DEPENDENCIES (formerly undocumented) variables, you
1243     should better define them in all directories.  This is easily done
1244     using an AC_SUBST (make sure you prefix these dependencies with
1245     $(top_srcdir) since this variable will appear at different
1246     levels of the build tree).
1247
1248   - aclocal will now use `m4_include' instead of copying local m4
1249     files into aclocal.m4.  (Local m4 files are those you ship with
1250     your project, other files will be copied as usual.)
1251
1252     Because m4_included files are automatically distributed, it means
1253     for most projects there is no point in EXTRA_DISTing the list of
1254     m4 files which are used.  (You can probably get rid of
1255     m4/Makefile.am if you had one.)
1256
1257   - aclocal will avoid touching aclocal.m4 when possible, so that
1258     Autom4te's cache isn't needlessly invalidated.  This behavior can
1259     be switched off with the new `--force' option.
1260
1261   - aclocal now uses Autoconf's --trace to detect macros which are
1262     actually used and will no longer include unused macros simply
1263     because they where mentioned.  This was often the case for macros
1264     called conditionally.
1265
1266   - New options no-dist and no-dist-gzip.
1267
1268   - compile, depcomp, elisp-comp, install-sh, mdate-sh, mkinstalldirs,
1269     py-compile, and ylwrap, now all understand --version and --help.
1270
1271   - Automake will now recognize AC_CONFIG_LINKS so far as removing created
1272     links as part of the distclean target and including source files in
1273     distributions.
1274
1275   - AM_PATH_PYTHON now supports ACTION-IF-FOUND and ACTION-IF-NOT-FOUND
1276     argument.  The latter can be used to override the default behavior
1277     (which is to abort).
1278
1279   - Automake will exit with $? = 63 on version mismatch.  (So does
1280     Autoconf 2.58)  missing knows this, and in this case it will
1281     emulate the tools as if they were absent.  Because older versions
1282     of Automake and Autoconf did not use this exit code, this change
1283     will only be useful in projects generated with future versions of
1284     these tools.
1285
1286   - When using AC_CONFIG_FILES with multiple input files, Automake
1287     generates the first ".in" input file for which a ".am" exists.
1288     (Former versions would try to use only the first input file.)
1289
1290   - lisp_DATA is now allowed.  If you are using the empty ELCFILES
1291     idiom to disable byte-compilation of lisp_LISP files, it is
1292     recommended that you switch to using lisp_DATA.  Note that
1293     this is not strictly equivalent: lisp_DATA will install elisp
1294     files even if emacs is not installed, while *_LISP do not
1295     install anything unless emacs is found.
1296
1297   - Makefiles will prefer `mkdir -p' over mkinstalldirs if it is
1298     available.  This selection is achieved through the Makefile
1299     variable $(mkdir_p) that is set by AM_INIT_AUTOMAKE to either
1300     `mkdir -m 0755 -p --', `$(mkinstalldirs) -m 0755', or
1301     `$(install_sh) -m 0755 -d'.
1302
1303 * Obsolete features
1304
1305   - Because `mkdir -p' is available on most platforms, and we can use
1306     `install-sh -d' when it is not, the use of the mkinstalldirs
1307     script is being phased out.  `automake --add-missing' no longer
1308     installs it, and if you remove mkinstalldirs from your package,
1309     automake will define $(mkinstalldirs) as an alias for $(mkdir_p).
1310
1311     Gettext 0.12.1 still requires mkinstalldirs.  Fortunately
1312     gettextize and autopoint will install it when needed.  Automake
1313     will continue to define the $(mkinstalldirs) and to distribute
1314     mkinstalldirs when this script is in the source tree.
1315
1316   - AM_PROG_CC_STDC is now empty.  The content of this macro was
1317     merged in AC_PROG_CC.  If your code uses $am_cv_prog_cc_stdc, you
1318     should adjust it to use $ac_cv_prog_cc_stdc instead.  (This
1319     renaming should be safe, even if you have to support several,
1320     versions of Automake, because AC_PROG_CC defines this variable
1321     since Autoconf 2.54.)
1322
1323   - Some users where using the undocumented ACLOCAL_M4_SOURCES
1324     variable to override the aclocal.m4 dependencies computed
1325     (inaccurately) by older versions of Automake.  Because Automake
1326     now tracks configure's m4 dependencies accurately (see m4_include
1327     above), the use of ACLOCAL_M4_SOURCES should be considered
1328     obsolete and will be flagged as such when running `automake
1329     -Wobsolete'.
1330
1331 * Bug fixes
1332
1333   - Defining programs conditionally using Automake conditionals no
1334     longer leads to a combinatorial explosion.  The following
1335     construct used to be troublesome when used with dozens of
1336     conditions.
1337
1338       bin_PROGRAMS = a
1339       if COND1
1340         bin_PROGRAMS += a1
1341       endif
1342       if COND2
1343         bin_PROGRAMS += a2
1344       endif
1345       if COND3
1346         bin_PROGRAMS += a3
1347       endif
1348       ...
1349
1350     Likewise for _SOURCES, _LDADD, and _LIBADD variables.
1351
1352   - Due to implementation constraints, previous versions of Automake
1353     proscribed multiple conditional definitions of some variables
1354     like bin_PROGRAMS:
1355
1356       if COND1
1357         bin_PROGRAMS = a1
1358       endif
1359       if COND2
1360         bin_PROGRAMS = a2
1361       endif
1362
1363     All _PROGRAMS, _LDADD, and _LIBADD variables were affected.
1364     This restriction has been lifted, and these variables now
1365     support multiple conditional definitions as do other variables.
1366
1367   - Cleanup the definitions of $(distdir) and $(top_distdir).
1368     $(top_distdir) now points to the root of the distribution
1369     directory created during `make dist', as it did in Automake 1.4,
1370     not to the root of the build tree as it did in intervening
1371     versions.  Furthermore these two variables are now only defined in
1372     the top level Makefile, and passed to sub-directories when running
1373     `make dist'.
1374
1375   - The --no-force option now correctly checks the Makefile.in's
1376     dependencies before deciding not to update it.
1377
1378   - Do not assume that make files are called Makefile in cleaning rules.
1379
1380   - Update .info files in the source tree, not in the build tree.  This
1381     is what the GNU Coding Standard recommend.  Only Automake 1.7.x
1382     used to update these files in the build tree (previous versions did
1383     it in the source tree too), and it caused several problems, varying
1384     from mere annoyance to portability issues.
1385
1386   - COPYING, COPYING.LIB, and COPYING.LESSER are no longer overwritten
1387     when --add-missing and --force-missing are used.  For backward
1388     compatibility --add-missing will continue to install COPYING (in
1389     `gnu' strictness) when none of these three files exist, but this
1390     use is deprecated: you should better choose a license yourself and
1391     install it once for all in your source tree (and in your code
1392     management system).
1393
1394   - Fix ylwrap so that it does not overwrite header files that haven't
1395     changed, as the inline rule already does.
1396
1397   - User-defined rules override automake-defined rules for the same
1398     targets, even when rules do not have commands.  This is not new
1399     (and was documented), however some of the automake-generated
1400     rules have escaped this principle in former Automake versions.
1401     Rules for the following targets are affected by this fix:
1402
1403        clean, clean-am, dist-all, distclean, distclean-am, dvi, dvi-am,
1404        info, info-am, install-data-am, install-exec-am, install-info,
1405        install-info-am, install-man, installcheck-am, maintainer-clean,
1406        maintainer-clean-am, mostlyclean, mostlyclean-am, pdf, pdf-am,
1407        ps, ps-am, uninstall-am, uninstall-info, uninstall-man
1408
1409     Practically it means that an attempt to supplement the dependencies
1410     of some target, as in
1411
1412        clean: my-clean-rule
1413
1414     will now *silently override* the automake definition of the
1415     rule for this target.  Running `automake -Woverride' will diagnose
1416     all such overriding definitions.
1417
1418     It should be noted that almost all these targets support a *-local
1419     variant that is meant to supplement the automake-defined rule
1420     (See node `Extending' in the manual).  The above rule should
1421     be rewritten as
1422
1423       clean-local: my-clean-rule
1424
1425     These *-local targets have been documented since at least
1426     Automake 1.2, so you should not fear the change if you have
1427     to support multiple automake versions.
1428
1429 * Miscellaneous
1430
1431   - The Automake manual is now distributed under the terms of the GNU FDL.
1432
1433   - Targets dist-gzip, dist-bzip2, dist-tarZ, dist-zip are always defined.
1434
1435   - core dumps are no longer removed by the cleaning rules.  There are
1436     at least three reasons for this:
1437       1. These files should not be created by any build step,
1438          so their removal do not fit any of the cleaning rules.
1439          Actually, they may be precious to the developer.
1440       2. If such file is created during a build, then it's clearly a
1441          bug Automake should not hide.  Not removing the file will
1442          cause `make distcheck' to complain about its presence.
1443       3. Operating systems have different naming conventions for
1444          core dump files.  A core file on one system might be a
1445          completely legitimate data file on another system.
1446
1447   - RUNTESTFLAGS, CTAGSFLAGS, ETAGSFLAGS, JAVACFLAGS are no longer
1448     defined by Automake.  This means that any definition in the
1449     environment will be used, unless overridden in the Makefile.am or
1450     on the command line.  The old behavior, where these variables were
1451     defined empty in each Makefile, can be obtained by AC_SUBSTing or
1452     AC_ARG_VARing each variable from configure.ac.
1453
1454   - CONFIGURE_DEPENDENCIES and CONFIG_STATUS_DEPENDENCIES are now
1455     documented.  (The is not a new feature, these variables have
1456     been there since at least Automake 1.4.)
1457
1458 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1459
1460 Bugs fixed in 1.7.9:
1461 * Fix install-strip to work with nobase_ binaries.
1462 * Fix renaming of #line directives in ylwrap.
1463 * Rebuild with Autoconf 2.59.  (1.7.8 was not installable with pdksh.)
1464
1465 Bugs fixed in 1.7.8:
1466 * Remove spurious blank lines in cleaning rules introduced in 1.7.7.
1467 * Fix detection of Debian's install-info, broken since version 1.5.
1468   (Debian bug #213524).
1469 * Honor -module if it appears in AM_LDFLAGS (i.e., relax name checking)
1470   This was only done for libfoo_LDFLAGS and LDFLAGS in previous versions.
1471
1472 Bugs fixed in 1.7.7:
1473 * The implementation of automake's --no-force option is unreliable,
1474   so this option is ignored in this version.  A real fix will appear in
1475   Automake 1.8.  (Debian Bug #206299)
1476 * AM_PATH_PYTHON: really check the whole list of interpreters if no
1477   argument is given.  (PR/399)
1478 * Do not warn about leading `_' in variable names, even with -Wportability.
1479 * Support user redefinitions of TEXINFO_TEX.
1480 * depcomp: support AIX Compiler version 6.
1481 * Fix missing rebuilds during `make dist' with BSD make.
1482   (Could produce tarballs containing out-of-date files.)
1483 * Resurrect multilib support.
1484 * Noteworthy manual updates:
1485   - Extending aclocal: how to write m4 macros that won't trigger warnings
1486     with Automake 1.8.
1487   - A Shared Library: Rewrite and split into subsections.
1488
1489 Bugs fixed in 1.7.6:
1490 * Fix depcomp's icc mode for ICC 7.1.
1491 * Diagnose calls to AC_CONFIG_FILES and friends with not enough arguments.
1492 * Fix maintainer-clean's removal of autom4te.cache in VPATH builds.
1493 * Fix AM_PATH_LISPDIR to work with POSIXLY_CORRECT=1.
1494 * Fix the location reported in some diagnostics related to AUTOMAKE_OPTIONS.
1495 * Remove Latin-1 characters from elisp-comp.
1496 * Update the manual's @dircategory to match the Free Software Directory.
1497
1498 Bugs fixed in 1.7.5:
1499 * Update install-sh's license to remove an advertising clause.
1500   (Debian bug #191717)
1501 * Fix a bug introduced in 1.7.4, related to BUILT_SOURCE handling,
1502   that caused invalid Makefile.ins to be generated.
1503 * Make sure AM_MAKE_INCLUDE doesn't fail when a `doit' file exists.
1504 * New FAQ entry: renamed objects.
1505
1506 Bugs fixed in 1.7.4:
1507 * Tweak the TAGS rule to support Exuberant Ctags (in addition to
1508   the Emacs implementation)
1509 * Fix output of aclocal.m4 dependencies in subdirectories.
1510 * Use `mv -f' instead of `mv' in fastdep rules.
1511 * Upgrade mdate-sh to work on OS/2.
1512 * Don't byte-compile elisp files when ELCFILES is set empty.
1513   (this documented feature was broken by 1.7.3)
1514 * Diagnose trailing backslashes on last line of Makefile.am.
1515 * Diagnose whitespace following trailing backslashes.
1516 * Multiple tests are now correctly supported in DEJATOOL. (PR/388)
1517 * Fix rebuilt rules for AC_CONFIG_FILES([Makefile:Makefile.in:Makefile.bot])
1518   Makefiles. (PR/389)
1519 * `make install' will build `BUILT_SOURCES' first.
1520 * Minor documentation fixes.
1521
1522 Bugs fixed in 1.7.3:
1523 * Fix stamp files numbering (when using multiple AC_CONFIG_HEADERS).
1524 * Query distutils for `pythondir' and `pythonexecdir', instead of
1525   using an hardcoded path.  This should allow builds on 64-bit
1526   distributions that usually use lib64/ instead of lib/.
1527 * AM_PATH_PYTHON will also search for python2.3.
1528 * elisp files are now built all at once instead of one by one. Besides
1529   incurring a speed-up, this is required to support interdependent elisp files.
1530 * Support for DJGPP:
1531   - `make distcheck' will now work in `_inst/' and `_build' instead
1532     of `=inst/' and `=build/'
1533   - use `_dirstamp' when the file-system doesn't support `.dirstamp'
1534   - install/uninstall `*.i[0-9][0-9]'-style info files
1535   - more changes that affect only the Automake package (not its output)
1536 * Fix some incompatibilities with upcoming perl-5.10.
1537 * Properly quote AC_PACKAGE_TARNAME and AC_PACKAGE_VERSION when defining
1538   PACKAGE and VERSION.
1539 * depcomp fixes:
1540   - dashmstdout and dashXmstdout modes: don't use `-o /dev/null', this
1541     is troublesome with gcc and Solaris compilers. (PR/385)
1542   - makedepend mode: work with Libtool. (PR/385 too)
1543   - support for ICC.
1544 * better support for unusual gettext setups, such as multiple po/ directories
1545   (PR/381):
1546   - Flag missing po/ and intl/ directories as warnings, not errors.
1547   - Disable these warnings if po/ does not exist.
1548 * Noteworthy manual updates:
1549   - New FAQ chapter.
1550   - Document how AC_CONFIG_AUX_DIR interacts with missing files.
1551     (Debian Bug #39542)
1552   - Document `AM_YFLAGS = -d'.  (PR/382)
1553
1554 Bugs fixed in 1.7.2:
1555 * Fix installation and uninstallation of Info files built in subdirectories.
1556 * Do not run `./configure --with-included-gettext' during `make distcheck'
1557   if AM_GNU_GETTEXT([external]) is used.
1558 * Correctly uninstall renamed man pages.
1559 * Do not strip escaped newline in variables defined in one condition
1560   and augmented in another condition.
1561 * Fix ansi2knr rules for LIBOBJS sources.
1562 * Clean all known Texinfo index files, not only those which appear to
1563   be used, because we cannot know which indexes are used in included files.
1564   (PR/375, Debian Bug #168671)
1565 * Honor only the first @setfilename seen in a Texinfo file.
1566 * Treat "required file X not found" diagnostics as errors (exit status 1).
1567 * Don't complain that a required file is not found when it is a Makefile
1568   target. (PR/357)
1569 * Don't use single suffix inference rules when building `.info'-less
1570   Info files, for the sake of Solaris make.
1571 * The `check' target now depends on `$(BUILT_SOURCES)'. (PR/359)
1572 * Recognize multiple inference rules such as `.a.b .c.d:'. (PR/371)
1573 * Warn about multiple inference rules when -Wportability is used. (PR/372)
1574 * Fix building of deansified files from subdirectories. (PR/370)
1575 * Add missing `fi' in the .c->.obj rules.
1576 * Improve install-sh to work even when names contain spaces or certain
1577   (but not all) shell metachars.
1578 * Fix the following spurious failures in the test suite:
1579   depcomp2.test, gnits2.test, gnits3.test, python3.test, texinfo13.test
1580 * Noteworthy manual updates:
1581   - Augment the section about BUILT_SOURCES.
1582   - Mention that AM_PROG_CC_STDC is a relic that is better avoided today.
1583
1584 Bugs fixed in 1.7.1:
1585 * Honor `ansi2knr' for files built in subdirectories, or using per-targets
1586   flags.
1587 * Aclocal should now recognize macro names containing parentheses, e.g.
1588   AC_DEFUN([AC_LANG_PREPROC(Fortran 90)], [...]).
1589 * Erase *.sum and *.log files created by DejaGnu, during `make distclean'.
1590   (Debian Bug#153697)
1591 * Install Python files even if they were built.  (PR/369)
1592 * Have stamp-vti dependent upon configure instead of configure.ac, as the
1593   version might not be defined in the latter. (PR/358)
1594 * Reorder arguments passed to a couple of commands, so things works
1595   when POSIXLY_CORRECT=1.
1596 * Fix a regex that can cause Perl to segfault on large input.
1597   (Debian Bug#162583)
1598 * Fix distribution of packages that have some sources defined conditionally,
1599   as in the `Conditional compilation using Automake conditionals' example
1600   of the manual.
1601 * Fix spurious test suite failures on IRIX.
1602 * Don't report a required variable as undefined if it has been
1603   defined conditionally for the "right" conditions.
1604 * Fix cleaning of the /tmp subdirectory used by `make distcheck', in case
1605   `make distcheck' fails.
1606 * Fix distribution of included Makefile fragment, so we don't create
1607   spurious directories in the distribution. (PR/366)
1608 * Don't complain that a target lacks `.$(EXEEXT)' when it has it.
1609
1610 New in 1.7:
1611 * Autoconf 2.54 is required.
1612 * `aclocal' and `automake' will no longer warn about obsolete
1613   configure macros.  This is done by `autoconf -Wobsolete'.
1614 * AM_CONFIG_HEADER, AM_SYS_POSIX_TERMIOS and
1615   AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL are obsolete (although still
1616   supported).  You should use AC_CONFIG_HEADERS, AC_SYS_POSIX_TERMIOS,
1617   and AC_HEADER_TIOCGWINSZ instead.  `autoupdate' can upgrade
1618   `configure.ac' for you.
1619 * Support for per-program and per-library `_CPPFLAGS'.
1620 * New `ctags' target (builds CTAGS files).
1621 * Support for -Wmumble and -Wno-mumble, where mumble is a warning category
1622   (see `automake --help' or the manual for a list of them).
1623 * Honor the WARNINGS environment variable.
1624 * Omit the call to depcomp when using gcc3: call the compiler directly.
1625 * A new option, std-options, tests that programs support --help and --version
1626   when `make installcheck' is run.  This is enabled by --gnits.
1627 * Texinfo rules now support the `ps' and `pdf' targets.
1628 * Info files are now created in the build directory, not the source directory.
1629 * info_TEXINFOS supports files in subdirectories (this requires Texinfo 4.1
1630   or greater).
1631 * `make distcheck' will enforce DESTDIR support by attempting
1632   a DESTDIR install.
1633 * `+=' can be used in conditionals, even if the augmented variable
1634   was defined for another condition.
1635 * Makefile fragments (inserted with `include') are always distributed.
1636 * Use Autoconf's --trace interface to inspect configure.ac and get
1637   a more accurate view of it.
1638 * Add support for extending aclocal's default macro search path
1639   using a `dirlist' file within the aclocal directory.
1640 * automake --output-dir is deprecated.
1641 * The part of the distcheck target that checks whether uninstall actually
1642   removes all installed files has been moved in a separate target,
1643   distuninstallcheck, so it can be overridden easily.
1644 * Many bug fixes.
1645
1646 New in 1.6.3:
1647 * Support for AM_INIT_GETTEXT([external])
1648 * Bug fixes, including:
1649   - Fix Automake's own `make install' so it works even if `ln' doesn't.
1650   - nobase_ programs and scripts honor --program-transform correctly.
1651   - Erase configure.lineno during `make distclean'.
1652   - Erase YACC and LEX outputs during `make maintainer-clean'.
1653
1654 New in 1.6.2:
1655 * Many bug fixes, including:
1656   - Requiring the current version works.
1657   - Fix "$@" portability issues (for Zsh).
1658   - Fix output of dummy dependency files in presence of post-processed
1659     Makefile.in's.
1660   - Don't compute dependencies in background to avoid races with libtool.
1661   - Fix handling of _OBJECTS variables for targets sharing source variables.
1662   - Check dependency mode for Java when AM_PROG_GCJ is used.
1663
1664 New in 1.6.1:
1665 * automake --output-dir is deprecated
1666 * Many bug fixes, including:
1667   - Don't choke on AM_LDFLAGS definitions.
1668   - Clean libtool objects from subdirectories.
1669   - Allow configure variables with reserved suffix and unknown prefix
1670     (e.g. AC_SUBST(mumble_LDFLAGS) when 'mumble' is not a target).
1671   - Fix the definition of AUTOMAKE and ACLOCAL in configure.
1672
1673 New in 1.6:
1674 * Autoconf 2.52 is required.
1675 * automake no longer run libtoolize.
1676   This is the job of autoreconf (from GNU Autoconf).
1677 * `dist' generates all the archive flavors, as did `dist-all'.
1678 * `dist-gzip' generates the Gzip tar file only.
1679 * Combining Automake Makefile conditionals no longer lead to a combinatorial
1680   explosion.  Makefile.in's keep a reasonable size.
1681 * AM_FUNC_ERROR_AT_LINE, AM_FUNC_STRTOD, AM_FUNC_OBSTACK, AM_PTRDIFF_T
1682   are no longer shipped, since Autoconf 2.52 provides them (both as AM_
1683   and AC_).
1684 * `#line' of Lex and Yacc files are properly set.
1685 * EXTRA_DIST can contain generated directories.
1686 * Support for dot-less extensions in suffix rules.
1687 * The part of the distcheck target that checks whether distclean actually
1688   cleans all built files has been moved in a separate target, distcleancheck,
1689   so it can be overridden easily.
1690 * `make distcheck' will pass additional options defined in
1691   $(DISTCHECK_CONFIGURE_FLAGS) to configure.
1692 * Fixed CDPATH portability problems, in particular for MacOS X.
1693 * Fixed handling of nobase_ targets.
1694 * Fixed support of implicit rules leading to .lo objects.
1695 * Fixed late inclusion of --add-missing files (e.g. depcomp) in DIST_COMMON
1696 * Added uninstall-hook target
1697 * `AC_INIT AM_INIT_AUTOMAKE(tarname,version)' is an obsolete construct.
1698   You can now use `AC_INIT(pkgname,version) AM_INIT_AUTOMAKE' instead.
1699   (Note that "pkgname" is not "tarname", see the manual for details.)
1700   It is also possible to pass a list of global Automake options as
1701   first argument to this new form of AM_INIT_AUTOMAKE.
1702 * Compiler-based assembler is now called `CCAS'; people expected `AS'
1703   to be a real assembler.
1704 * AM_INIT_AUTOMAKE will set STRIP itself when it needs it.  Adding
1705   AC_CHECK_TOOL([STRIP], [strip]) manually is no longer required.
1706 * aclocal and automake are also installed with the version number
1707   appended, and some of the install directory names have changed.
1708   This lets you have multiple versions installed simultaneously.
1709 * Support for parsers and lexers in subdirectories.
1710
1711 New in 1.5:
1712 * Support for `configure.ac'.
1713 * Support for `else COND', `endif COND' and negated conditions `!COND'.
1714 * `make dist-all' is much faster.
1715 * Allows '@' AC_SUBSTs in macro names.
1716 * Faster AM_INIT_AUTOMAKE (requires update of `missing' script)
1717 * User-side dependency tracking.  Developers no longer need GNU make
1718 * Python support
1719 * Uses DIST_SUBDIRS in some situations when SUBDIRS is conditional
1720 * Most files are correctly handled if they appear in subdirs
1721   For instance, a _DATA file can appear in a subdir
1722 * GNU tar is no longer required for `make dist'
1723 * Added support for `dist_' and `nodist_' prefixes
1724 * Added support for `nobase_' prefix
1725 * Compiled Java support
1726 * Support for per-executable and per-library compilation flags
1727 * Many bug fixes
1728
1729 New in 1.4:
1730 * Added support for the Fortran 77 programming language.
1731 * Re-indexed the Automake Texinfo manual.
1732 * Added `AM_FOOFLAGS' variable for each compiler invocation;
1733   e.g. AM_CFLAGS can be used in Makefile.am to set C compiler flags
1734 * Support for latest autoconf, including support for objext
1735 * Can now put `.' in SUBDIRS to control build order
1736 * `include' command and `+=' support for macro assignment
1737 * Dependency tracking no long susceptible to deleted header file problem
1738 * Maintainer mode now a conditional.  @MAINT@ is now an anachronism.
1739 * Bug fixes
1740
1741 New in 1.3:
1742 * Bug fixes
1743 * Better Cygwin32 support
1744 * Support for suffix rules with _SOURCES variables
1745 * New options `readme-alpha' and `check-news'; Gnits mode sets these
1746 * @LEXLIB@ no longer required when lex source seen
1747   Lex support in `missing', and new lex macro.  Update your missing script.
1748 * Built-in support for assembly
1749 * aclocal gives error if `AM_' macro not found
1750 * Passed YFLAGS, not YACCFLAGS, to yacc
1751 * AM_PROG_CC_STDC does not have to come before AC_PROG_CPP
1752 * Dependencies computed as a side effect of compilation
1753 * Preliminary support for Java
1754 * DESTDIR support at "make install" time
1755 * Improved ansi2knr support; you must use the latest ansi2knr.c (included)
1756
1757 New in 1.2:
1758 * Bug fixes
1759 * Better DejaGnu support
1760 * Added no-installinfo option
1761 * Added Emacs Lisp support
1762 * Added --no-force option
1763 * Included `aclocal' program
1764 * Automake will now generate rules to regenerate aclocal.m4, if appropriate
1765 * Now uses `AM_' macro names everywhere
1766 * ansi2knr option can have directory prefix (eg `../lib/ansi2knr')
1767   ansi2knr now works correctly on K&R sources
1768 * Better C++, yacc, lex support
1769 * Will compute _DEPENDENCIES variables automatically if not supplied
1770 * Will interpolate $(...) and ${...} when examining contents of a variable
1771 * .deps files now in build directory, not source directory; dependency
1772   handling generally rewritten
1773 * DATA, MANS and BUILT_SOURCES no longer included in distribution
1774 * can now put config.h into a subdir
1775 * Added dist-all target
1776 * Support for install-info program (see texinfo 3.9)
1777 * Support for "yacc -d"
1778 * configure substitutions are automatically discovered and included
1779   in generated Makefile.in
1780 * Special --cygnus mode
1781 * OMIT_DEPENDENCIES can now hold list of dependencies to be omitted
1782   when making distribution.  Some dependencies are auto-ignored.
1783 * Changed how libraries are specified in _LIBRARIES variable
1784 * Full libtool support, from Gord Matzigkeit
1785 * No longer have to explicitly touch stamp-h when using AC_CONFIG_HEADER;
1786   AM_CONFIG_HEADER handles it automatically
1787 * Texinfo output files no longer need .info extension
1788 * Added `missing' support
1789 * Cygwin32 support
1790 * Conditionals in Makefile.am, from Ian Taylor
1791
1792 New in 1.0:
1793 * Bug fixes
1794 * distcheck target runs install and installcheck targets
1795 * Added preliminary support for DejaGnu.
1796
1797 New in 0.33:
1798 * More bug fixes
1799 * More checking
1800 * More libtool fixes from Gord Matzigkeit; libtool support is still
1801   preliminary however
1802 * Added support for jm_MAINTAINER_MODE
1803 * dist-zip support
1804 * New "distcheck" target
1805
1806 New in 0.32:
1807 * Many bug fixes
1808 * mkinstalldirs and mdate-sh now appear in directory specified by
1809   AC_CONFIG_AUX_DIR.
1810 * Removed DIST_SUBDIRS, DIST_OTHER
1811 * AC_ARG_PROGRAM only required when an actual program exists
1812 * dist-hook target now run before distribution packaged up; idea from
1813   Dieter Baron.  Other hooks exist, too.
1814 * Preliminary (unfinished) support for libtool
1815 * Added short option names.
1816 * Better "dist" support when gluing together multiple packages
1817
1818 New in 0.31:
1819 * Bug fixes
1820 * Documentation updates (many from François Pinard)
1821 * strictness `normal' now renamed to `foreign'
1822 * Renamed --install-missing to --add-missing
1823 * Now handles AC_CONFIG_AUX_DIR
1824 * Now handles TESTS macro
1825 * DIST_OTHER renamed to EXTRA_DIST
1826 * DIST_SUBDIRS is deprecated
1827 * @ALLOCA@ and @LIBOBJS@ now work in _LDADD variables
1828 * Better error messages in many cases
1829 * Program names are canonicalized
1830 * Added "check" prefix; from Gord Matzigkeit
1831
1832 New in 0.30:
1833 * Bug fixes
1834 * configure.in scanner knows about AC_PATH_XTRA, AC_OUTPUT ":" syntax
1835 * Beginnings of a test suite
1836 * Automatically adds -I options for $(srcdir), ".", and path to config.h
1837 * Doesn't print anything when running
1838 * Beginnings of MAINT_CHARSET support
1839 * Can specify version in AUTOMAKE_OPTIONS
1840 * Most errors recognizable by Emacs' M-x next-error
1841 * Added --verbose option
1842 * All "primary" variables now obsolete; use EXTRA_PRIMARY to supply
1843   configure-generated names
1844 * Required macros now distributed in aclocal.m4
1845 * New documentation
1846 * --strictness=gnu is default
1847
1848 New in 0.29:
1849 * Many bug fixes
1850 * More sophisticated configure.in scanning; now understands ALLOCA and
1851   LIBOBJS directly, handles AC_CONFIG_HEADER more precisely, etc.
1852 * TEXINFOS and MANS now obsolete; use info_TEXINFOS and man_MANS instead.
1853 * CONFIG_HEADER variable now obsolete
1854 * Can handle multiple Texinfo sources
1855 * Allow hierarchies deeper than 2.  From Gord Matzigkeit.
1856 * HEADERS variable no longer needed; now can put .h files directly into
1857   foo_SOURCES variable.
1858 * Automake automatically rebuilds files listed in AC_OUTPUT.  The
1859   corresponding ".in" files are included in the distribution.
1860
1861 New in 0.28:
1862 * Added --gnu and --gnits options
1863 * More standards checking
1864 * Bug fixes
1865 * Cleaned up 'dist' targets
1866 * Added AUTOMAKE_OPTIONS variable and several options
1867 * Now scans configure.in to get some information (preliminary)
1868
1869 New in 0.27:
1870 * Works with Perl 4 again
1871
1872 New in 0.26:
1873 * Added --install-missing option.
1874 * Pretty-prints generated macros and rules
1875 * Comments in Makefile.am are placed more intelligently in Makefile.in
1876 * Generates .PHONY target
1877 * Rule or macro in Makefile.am now overrides contents of Automake file
1878 * Substantial cleanups from François Pinard
1879
1880 New in 0.25:
1881 * Bug fixes.
1882 * Works with Perl 4 again.
1883
1884 New in 0.24:
1885 * New uniform naming scheme.
1886 * --strictness option
1887 * Works with Perl 5
1888 * '.c' files corresponding to '.y' or '.l' files are automatically
1889   distributed.
1890 * Many bug fixes and cleanups
1891
1892 New in 0.23:
1893 * Allow objects to be conditionally included in libraries via lib_LIBADD.
1894
1895 New in 0.22:
1896 * Bug fixes in 'clean' code.
1897 * Now generates 'installdirs' target.
1898 * man page installation reworked.
1899 * 'make dist' no longer re-creates all Makefile.in's.
1900
1901 New in 0.21:
1902 * Reimplemented in Perl
1903 * Added --amdir option (for debugging)
1904 * Texinfo support cleaned up.
1905 * Automatic de-ANSI-fication cleaned up.
1906 * Cleaned up 'clean' targets.
1907
1908 New in 0.20:
1909 * Automatic dependency tracking
1910 * More documentation
1911 * New variables DATA and PACKAGEDATA
1912 * SCRIPTS installed using $(INSTALL_SCRIPT)
1913 * No longer uses double-colon rules
1914 * Bug fixes
1915 * Changes in advance of internationalization
1916
1917 -----
1918
1919 Copyright (C) 1995-2012 Free Software Foundation, Inc.
1920
1921 This program is free software; you can redistribute it and/or modify
1922 it under the terms of the GNU General Public License as published by
1923 the Free Software Foundation; either version 2, or (at your option)
1924 any later version.
1925
1926 This program is distributed in the hope that it will be useful,
1927 but WITHOUT ANY WARRANTY; without even the implied warranty of
1928 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1929 GNU General Public License for more details.
1930
1931 You should have received a copy of the GNU General Public License
1932 along with this program.  If not, see <http://www.gnu.org/licenses/>.