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