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