* configure.ac, NEWS: Bump version to 1.8d.
[platform/upstream/automake.git] / NEWS
1 New in 1.8d:
2
3 * Makefile.in bloat reduction:
4
5   - Inference rules are used to compile sources in subdirectories when
6     the `subdir-objects' option is used and no per-target flags are
7     used.  This should reduce the size of some projects a lot, because
8     Automake used to output an explicit rule for each such object in
9     the past.
10
11   - Automake no longer outputs three rules (.o, .obj, .lo) for each
12     object that must be built with explicit rules.  It just outputs
13     the rules required to build the kind of object considered: either
14     the two .o and .obj rules for usual objects, or the .lo rule for
15     libtool objects.
16
17 * Change to Libtool support:
18
19   - Libtool tags are used with libtool versions that support them.
20     (I.e., with Libtool 1.5 or greater.)
21
22   - Automake is now able to handle setups where a libtool library is
23     conditionally installed in different directories, as in
24
25       if COND
26         lib_LTLIBRARIES = liba.la
27       else
28         pkglib_LTLIBRARIES = liba.la
29       endif
30       liba_la_SOURCES = ...
31
32 * Changes to aclocal:
33
34   - aclocal now ensures that AC_DEFUNs and AU_DEFUNs it discovers are
35     really evaluated, before it decides to include them in aclocal.m4.
36     This solves nasty problems with conditional redefinitions of
37     Autoconf macros in /usr/share/aclocal/*.m4 files causing extraneous
38     *.m4 files to be included in any project using these macros.
39     (Calls to AC_PROG_EGREP causing libtool.m4 to be included is the
40     most famous instance of this bug.)
41
42   - Do not complain about missing conditionally AC_REQUIREd macros
43     that are not actually used.  In 1.8.x aclocal would correctly
44     determine which of these macros were really needed (and include
45     only these in the package); unfortunately it would also require
46     all of them to be present in order to run.  This created
47     situations were aclocal would not work on a tarball distributing
48     all the macros it uses.  For instance running aclocal on a project
49     containing only the subset of the Gettext macros in use by the
50     project did not work, because gettext conditionally requires other
51     macros.
52
53 * Portability improvements:
54
55   - Tar format can be chosen with the new options tar-v7, tar-ustar, and
56     tar-pax.  The new option filename-length-max=99 helps diagnosing
57     filenames that are too long for tar-v7.  (PR/414)
58
59   - Variables aumented with `+=' are now automatically flattened (i.e.,
60     trailing backslashes removed) and then wrapped around 80 colummns
61     (adding trailing backslashes).  In previous versions, a long series
62     of
63       VAR += value1
64       VAR += value2
65       VAR += value3
66       ...
67     would result in a single-line definition of VAR that could possibly
68     exceed the maximum line length of some make implementations.
69
70     Non-augmented variables are still output as they are defined in
71     the Makefile.am.
72
73 * Miscellaneous:
74
75   - Support Fortran 90/95 with the new "fc" and "ppfc" languages.
76     Works the same as the old Fortran 77 implementation; just replace
77     F77 with FC everywhere (exception: FFLAGS becomes FCFLAGS).
78     Requires a version of autoconf which provides AC_PROG_FC (>=2.59).
79
80   - Support for conditional _LISP.
81
82   - Support for conditional -hook and -local rules (PR/428).
83
84   - Diagnose AC_CONFIG_AUX_DIR calls following AM_INIT_AUTOMAKE. (PR/49)
85
86   - Automake will not write any Makefile.ins after the first error it
87     encounters.  The previous Makefile.ins (if any) will be left in
88     place.  (Warnings will not prevent output, but remember they can
89     be turned into errors with -Werror.)
90
91   - The restriction that SUBDIRS must contain direct children is gone.
92     Do not abuse.
93
94   - The manual tells more about SUBDIRS vs. DIST_SUBDIRS.
95     It also gives an example of nested packages using AC_CONFIG_SUBDIRS.
96 \f
97 Bugs fixed in 1.8.5:
98
99 * Long standing bugs:
100
101   - Define DIST_SUBDIRS even when the `no-dist' or `cygnus' options are used
102     so that `make distclean' and `make maintainer-clean' can work.
103
104   - Define AR and ARFLAGS even when only EXTRA_LIBRARIES are defined.
105
106   - Fix many rules to please FreeBSD make, which runs commands with `sh -e'.
107
108   - Polish diagnostic when no input file is found.
109 \f
110 Bugs fixed in 1.8.4:
111
112 * Long standing bugs:
113
114   - Fix AM_PATH_PYTHON to correctly display $PYTHON when it has been
115     overridden by the user.
116
117   - Honor PATH_SEPARATOR in various places of the Automake package, for
118     the sake of OS/2.
119
120   - Adjust dependency tracking mode detection to ICC 8.0's new output.
121     (PR/416)
122
123   - Fix install-sh so it can install the `mv' binary... using `mv'.
124
125   - Fix tru64 dependency tracking for libtool objects.
126
127   - Work around Exuberant Ctags when creating a TAGS files in a directory
128     without files to scan but with subdirectories to include.
129
130 * Bugs introduced by 1.8:
131
132   - Fix an "internal error" when @LIBOBJS@ is used in a variable that is
133     not defined in the same conditions as the _LDADD that uses it.
134
135   - Do not warn when JAVAROOT is overridden, this is legitimate.
136 \f
137 Bugs fixed in 1.8.3:
138
139 * Long standing bugs:
140
141   - Quote filenames in installation rules, in case $DESTDIR, $prefix,
142     or any of the other *dir variables contain a space.
143
144     Please note that Automake does not and cannot support spaces in
145     filenames that are involved during the build.  This change affects
146     only installation paths, so that `make install' does not bomb out
147     in packages configured with
148       ./configure --prefix '/c/Program Files'
149
150   - Fix the depfiles output so it works with GNU sed (<4.1) even when
151     POSIXLY_CORRECT is set.
152
153   - Do not AC_SUBST(LIBOBJS) in AM_WITH_REGEX.  This macro was unusable
154     since Autoconf 2.54, which defines LIBOBJS itself.
155
156   - Fix a potential (but unlikely) race condition in parallel elisp
157     builds.  (Introduced in 1.7.3.)
158
159   - Do not assume that users override _DEPENDENCIES in all conditions
160     where Automake will try to define them.
161
162   - Do not use `mkdir -p' in mkinstalldirs, unless this is GNU mkdir.
163     Solaris 8's `mkdir -p' is not thread-safe and can break parallel
164     builds.
165
166     This fix also affects the $(mkdir_p) variable defined since
167     Automake 1.8.  It will be set to `mkdir -p' only if mkdir is GNU
168     mkdir, and to `mkinstalldirs' or `install-sh -d' otherwise.
169
170   - Secure temporary directory creation in `make distcheck'. (PR/413)
171
172   - Do not generate two build rules for `parser.h' when the
173     parser appears in two different conditionals.
174
175   - Work around a Solaris 8 /bin/sh bug in the test for dependency
176     checking.  Usually ./configure will not pick this shell; so this
177     fix only helps cases where the shell is forced to /bin/sh.
178
179 * Bugs introduced by 1.8:
180
181   - In some situations (hand-written `m4_include's), aclocal would
182     call the `File::Spec->rel2abs' method, which was only introduced
183     in Perl 5.6.  This new version reestablish support Perl 5.005.
184
185     It is likely that the next major Automake releases will require at
186     least Perl 5.6.  Consider upgrading your development environment
187     if you are still using the five-year-old Perl 5.005.
188
189   - Automake would sometimes fail to define rules for targets listed
190     in variables defined in multiple conditions.  For instance on
191       if C1
192         bin_PROGRAMS = a
193       else
194         bin_PROGRAMS = b
195       endif
196     it would define only the `a.$(OBJEXT): a.c' rule and omit the
197     `b.$(OBJEXT): b.c' rule.
198
199 * New sections in manual:
200
201   - Third-Party Makefiles: how to interface third party Makefiles.
202   - Upgrading: upgrading packages to newer Automake versions.
203   - Multiple Outputs: handling tools that produce many outputs.
204 \f
205 Bug fixed in 1.8.2:
206
207 * A (well known) portability bug slipped in the changes made to
208   install-sh in Automake 1.8.1.  The broken install-sh would refuse to
209   install anything on Tru64.
210
211 * Fix install rules for conditionally built python files.  (This never
212   really worked.)
213 \f
214 Bug fixed in 1.8.1:
215
216 * Bugs introduced by 1.8:
217
218   - Fix Config.pm import error with old Perl versions (at least
219     5.005_03).  One symptom is that aclocal could not find its macro
220     directory.
221
222   - Automake 1.8 used `mkdir -m 0755 -p --' to ensure that directories
223     created by `make install' are always world readable, even if the
224     installer happens to have an overly restrictive umask (e.g. 077).
225     This was a mistake and has been reverted.  There are at least two
226     reasons why we must not use `-m 0755':
227       - it causes special bits like SGID to be ignored,
228       - it may be too restrictive (some setups expect 775 directories).
229
230   - Fix aclocal to honor definitions located in files which have been
231     m4_included manually.  aclocal 1.8 had been updated to check
232     m4_included files for new requirements, but forgot that these
233     m4_included files can also provide new definitions.
234
235     Note that if you have such a setup, we recommend you get rid of
236     it.  In the past, there was a reason to m4_include files manually:
237     aclocal used to duplicate entire M4 files into aclocal.m4, even
238     files that were distributed.  Some packages were therefore
239     m4_including the distributed file directly, and playing some
240     tricks to ensure aclocal would not copy that file to aclocal.m4,
241     in order to limit the amount of duplication.  Since aclocal 1.8.x
242     will precisely output m4_includes for local M4 files, we recommend
243     that you clean up your setup, removing all manual m4_includes and
244     letting aclocal output them.
245
246   - Output detailed menus in the Info version if the Automake manual,
247     so that Emacs can locate the indexes.
248
249   - configure.ac and configure were listed twice in DIST_COMMON (an
250     internal variable where Automake lists configury files to
251     distribute).  This was harmless, but unaesthetic.
252
253   - Use `chmod a-w' instead of `chmod -w' as the latter honors umask.
254     This was an issue only in the Automake package itself, not in
255     its output.
256
257   - Automake assumed that all AC_CONFIG_LINKS arguments had the form
258     DEST:SRC.  This was wrong, as some packages do
259     AC_CONFIG_LINKS($computedlinks).  This version no longer abort in
260     that situation.
261
262   - Contrary to mkinstalldirs, $(mkdir_p) was expecting exactly one
263     argument.  This caused two kinds of failures:
264       - Rules installing data in a conditionally defined directory
265         failed when that directory was undefined.  In this case no
266         argument was supplied.
267       - `make installdirs' failed, because several directories were
268         passed to $(mkdir_p).  This was an issue only on platform
269         were $(mkdir_p) is implemented with `install-sh -d'.
270     $(mkdir_p) as been changed to accept 0 or more arguments, as
271     mkinstalldirs did.
272
273 * Long-standing bugs:
274
275   - Fix an unexpected diagnostic occurring when users attempt
276     to override some internal variables that Automake appends to.
277
278   - aclocal now scans configure.ac for macro definitions (PR/319).
279
280   - Fix a portability issue with OSF1/Tru64 Make.  If a directory
281     distributes files which are outside itself (this usually occurs
282     when using AC_CONFIG_AUX_DIR([../dir]) to use auxiliary files
283     from a parent package), then `make distcheck' fails due to an
284     optimization performed by OSF1/Tru64 Make in its VPATH handling.
285     (tests/subpkg2.test failure)
286
287   - Fix another portability issue with Sun and OSF1/Tru64 Make.
288     In a VPATH-build configuration, `make install' would install
289     nobase_ files to wrong locations.
290
291   - Fix a Perl `uninitialized value' diagnostic occurring when
292     automake complains that a Texinfo file does not have a
293     @setfilename statement.
294
295   - Erase config.status.lineno during `make distclean'.  This file
296     can be created by config.status.  Automake already knew about
297     configure.lineno, but forgot config.status.lineno.
298
299   - Distribute all files, even those which are built and installed
300     conditionally.  This change affects files listed in conditionally
301     defined *_HEADERS and *_PYTHON variable (unless they are nodist_*)
302     as well as those listed in conditionally defined dist_*_DATA,
303     dist_*_JAVA, dist_*_LISP, and dist_*_SCRIPTS variables.
304
305   - Fix AM_PATH_LISPDIR to avoid \? in sed regular expressions; it
306     doesn't conform to POSIX.
307
308   - Normalize help strings for configure variables and options added
309     by Automake macros.
310
311 * Anticipation:
312
313   - Check for python2.4 in AM_PATH_PYTHON.
314
315 * Spurious failures in test suite:
316
317   - tests/libtool5.test, tests/ltcond.test, tests/ltcond2.test,
318     tests/ltconv.test: fix failures with CVS Libtool.
319   - tests/aclocal6.test: fix failure if autom4te.cache is disabled.
320   - tests/txinfo24.test, tests/txinfo25.test, tests/txinfo28.test:
321     fix failures with old Texinfo versions.
322 \f
323 New in 1.8:
324
325 * Meta-News
326
327   - The NEWS file is more verbose.
328
329 * Requirements
330
331   - Autoconf 2.58 or greater is required.
332
333 * New features
334
335   - Default source file names in the absence of a _SOURCES declaration
336     are made by removing any target extension before appending `.c', so
337     to make the libtool module `foo.la' from `foo.c', you only need to
338     do this:
339
340         lib_LTLIBRARIES = foo.la
341         foo_la_LDFLAGS  = -module
342
343     For backward compatibility, foo_la.c will be used instead of
344     foo.c if this file exists or is the explicit target of a rule.
345     However -Wobsolete will warn about this deprecated naming.
346
347   - AR's `cru' flags are now set in a global ARFLAGS variable instead
348     of being hard-coded in each $(AR) invocation, so they can be
349     substituted from configure.ac.  This has been requested by people
350     dealing with non-POSIX ar implementations.
351
352   - New warning option: -Woverride.  This will warn about any user
353     target or variable definitions which override Automake
354     definitions.
355
356   - Texinfo rules back up and restore info files when makeinfo fails.
357
358   - Texinfo rules now support the `html' target.
359     Running this requires Texinfo 4.0 or greater.
360
361     `html' is a new recursive target, so if your package mixes
362     hand-crafted `Makefile.in's with Automake-generated
363     `Makefile.in's, you should adjust the former to support (or
364     ignore) this target so that `make html' recurses successfully.  If
365     you had a custom `html' rule in your `Makefile.am', it's better to
366     rename it as `html-local', otherwise your rule will override
367     Automake's new rule (you can check that by running `automake
368     -Woverride') and that will stop the recursion to subdirectories.
369
370     Last but not least, this `html' rule is declared PHONY, even when
371     overridden.  Fortunately, it appears that few packages use a
372     non-PHONY `html' rule.
373
374   - Any file which is m4_included from configure.ac will appear as a
375     configure and Makefile.in dependency, and will be automatically
376     distributed.
377
378   - The rules for rebuilding Makefiles and Makefile.ins will now
379     rebuild all Makefiles and all Makefile.ins at once when one of
380     configure's dependencies has changed.  This is considerably faster
381     than previous implementations, where config.status and automake
382     were run separately in each directory (this still happens when you
383     change a Makefile.am locally, without touching configure.ac or
384     friends).  Doing this also solves a longstanding issue: these
385     rebuild rules failed to work when adding new directories to the
386     tree, forcing you to run automake manually.
387
388   - For similar reasons, the rules to rebuild configure,
389     config.status, and aclocal.m4 are now defined in all directories.
390     Note that if you were using the CONFIG_STATUS_DEPENDENCIES and
391     CONFIGURE_DEPENDENCIES (formerly undocumented) variables, you
392     should better define them in all directories.  This is easily done
393     using an AC_SUBST (make sure you prefix these dependencies with
394     $(top_srcdir) since this variable will appear at different
395     levels of the build tree).
396
397   - aclocal will now use `m4_include' instead of copying local m4
398     files into aclocal.m4.  (Local m4 files are those you ship with
399     your project, other files will be copied as usual.)
400
401     Because m4_included files are automatically distributed, it means
402     for most projects there is no point in EXTRA_DISTing the list of
403     m4 files which are used.  (You can probably get rid of
404     m4/Makefile.am if you had one.)
405
406   - aclocal will avoid touching aclocal.m4 when possible, so that
407     Autom4te's cache isn't needlessly invalidated.  This behavior can
408     be switched off with the new `--force' option.
409
410   - aclocal now uses Autoconf's --trace to detect macros which are
411     actually used and will no longer include unused macros simply
412     because they where mentioned.  This was often the case for macros
413     called conditionally.
414
415   - New options no-dist and no-dist-gzip.
416
417   - compile, depcomp, elisp-comp, install-sh, mdate-sh, mkinstalldirs,
418     py-compile, and ylwrap, now all understand --version and --help.
419
420   - Automake will now recognize AC_CONFIG_LINKS so far as removing created
421     links as part of the distclean target and including source files in
422     distributions.
423
424   - AM_PATH_PYTHON now supports ACTION-IF-FOUND and ACTION-IF-NOT-FOUND
425     argument.  The latter can be used to override the default behavior
426     (which is to abort).
427
428   - Automake will exit with $? = 63 on version mismatch.  (So does
429     Autoconf 2.58)  missing knows this, and in this case it will
430     emulate the tools as if they were absent.  Because older versions
431     of Automake and Autoconf did not use this exit code, this change
432     will only be useful in projects generated with future versions of
433     these tools.
434
435   - When using AC_CONFIG_FILES with multiple input files, Automake
436     generates the first ".in" input file for which a ".am" exists.
437     (Former versions would try to use only the first input file.)
438
439   - lisp_DATA is now allowed.  If you are using the empty ELCFILES
440     idiom to disable byte-compilation of lisp_LISP files, it is
441     recommended that you switch to using lisp_DATA.  Note that
442     this is not strictly equivalent: lisp_DATA will install elisp
443     files even if emacs is not installed, while *_LISP do not
444     install anything unless emacs is found.
445
446   - Makefiles will prefer `mkdir -p' over mkinstalldirs if it is
447     available.  This selection is achieved through the Makefile
448     variable $(mkdir_p) that is set by AM_INIT_AUTOMAKE to either
449     `mkdir -m 0755 -p --', `$(mkinstalldirs) -m 0755', or
450     `$(install_sh) -m 0755 -d'.
451
452 * Obsolete features
453
454   - Because `mkdir -p' is available on most platforms, and we can use
455     `install-sh -d' when it is not, the use of the mkinstalldirs
456     script is being phased out.  `automake --add-missing' no longer
457     installs it, and if you remove mkinstalldirs from your package,
458     automake will define $(mkinstalldirs) as an alias for $(mkdir_p).
459
460     Gettext 0.12.1 still requires mkinstalldirs.  Fortunately
461     gettextize and autopoint will install it when needed.  Automake
462     will continue to define the $(mkinstalldirs) and to distribute
463     mkinstalldirs when this script is in the source tree.
464
465   - AM_PROG_CC_STDC is now empty.  The content of this macro was
466     merged in AC_PROG_CC.  If your code uses $am_cv_prog_cc_stdc, you
467     should adjust it to use $ac_cv_prog_cc_stdc instead.  (This
468     renaming should be safe, even if you have to support several,
469     versions of Automake, because AC_PROG_CC defines this variable
470     since Autoconf 2.54.)
471
472   - Some users where using the undocumented ACLOCAL_M4_SOURCES
473     variable to override the aclocal.m4 dependencies computed
474     (inaccurately) by older versions of Automake.  Because Automake
475     now tracks configure's m4 dependencies accurately (see m4_include
476     above), the use of ACLOCAL_M4_SOURCES should be considered
477     obsolete and will be flagged as such when running `automake
478     -Wobsolete'.
479
480 * Bug fixes
481
482   - Defining programs conditionally using Automake conditionals no
483     longer leads to a combinatorial explosion.  The following
484     construct used to be troublesome when used with dozens of
485     conditions.
486
487       bin_PROGRAMS = a
488       if COND1
489         bin_PROGRAMS += a1
490       endif
491       if COND2
492         bin_PROGRAMS += a2
493       endif
494       if COND3
495         bin_PROGRAMS += a3
496       endif
497       ...
498
499     Likewise for _SOURCES, _LDADD, and _LIBADD variables.
500
501   - Due to implementation constraints, previous versions of Automake
502     proscribed multiple conditional definitions of some variables
503     like bin_PROGRAMS:
504
505       if COND1
506         bin_PROGRAMS = a1
507       endif
508       if COND2
509         bin_PROGRAMS = a2
510       endif
511
512     All _PROGRAMS, _LDADD, and _LIBADD variables were affected.
513     This restriction has been lifted, and these variables now
514     support multiple conditional definitions as do other variables.
515
516   - Cleanup the definitions of $(distdir) and $(top_distdir).
517     $(top_distdir) now points to the root of the distribution
518     directory created during `make dist', as it did in Automake 1.4,
519     not to the root of the build tree as it did in intervening
520     versions.  Furthermore these two variables are now only defined in
521     the top level Makefile, and passed to sub-directories when running
522     `make dist'.
523
524   - The --no-force option now correctly checks the Makefile.in's
525     dependencies before deciding not to update it.
526
527   - Do not assume that make files are called Makefile in cleaning rules.
528
529   - Update .info files in the source tree, not in the build tree.  This
530     is what the GNU Coding Standard recommend.  Only Automake 1.7.x
531     used to update these files in the build tree (previous versions did
532     it in the source tree too), and it caused several problems, varying
533     from mere annoyance to portability issues.
534
535   - COPYING, COPYING.LIB, and COPYING.LESSER are no longer overwritten
536     when --add-missing and --force-missing are used.  For backward
537     compatibility --add-missing will continue to install COPYING (in
538     `gnu' strictness) when none of these three files exist, but this
539     use is deprecated: you should better choose a license yourself and
540     install it once for all in your source tree (and in your code
541     management system).
542
543   - Fix ylwrap so that it does not overwrite header files that haven't
544     changed, as the inline rule already does.
545
546   - User-defined rules override automake-defined rules for the same
547     targets, even when rules do not have commands.  This is not new
548     (and was documented), however some of the automake-generated
549     rules have escaped this principle in former Automake versions.
550     Rules for the following targets are affected by this fix:
551
552        clean, clean-am, dist-all, distclean, distclean-am, dvi, dvi-am,
553        info, info-am, install-data-am, install-exec-am, install-info,
554        install-info-am, install-man, installcheck-am, maintainer-clean,
555        maintainer-clean-am, mostlyclean, mostlyclean-am, pdf, pdf-am,
556        ps, ps-am, uninstall-am, uninstall-info, uninstall-man
557
558     Practically it means that an attempt to supplement the dependencies
559     of some target, as in
560
561        clean: my-clean-rule
562
563     will now *silently override* the automake definition of the
564     rule for this target.  Running `automake -Woverride' will diagnose
565     all such overriding definitions.
566
567     It should be noted that almost all these targets support a *-local
568     variant that is meant to supplement the automake-defined rule
569     (See node `Extending' in the manual).  The above rule should
570     be rewritten as
571
572       clean-local: my-clean-rule
573
574     These *-local targets have been documented since at least
575     Automake 1.2, so you should not fear the change if you have
576     to support multiple automake versions.
577
578 * Miscellaneous
579
580   - The Automake manual is now distributed under the terms of the GNU FDL.
581
582   - Targets dist-gzip, dist-bzip2, dist-tarZ, dist-zip are always defined.
583
584   - core dumps are no longer removed by the cleaning rules.  There are
585     at least three reasons for this:
586       1. These files should not be created by any build step,
587          so their removal do not fit any of the cleaning rules.
588          Actually, they may be precious to the developer.
589       2. If such file is created during a build, then it's clearly a
590          bug Automake should not hide.  Not removing the file will
591          cause `make distcheck' to complain about its presence.
592       3. Operating systems have different naming conventions for
593          core dump files.  A core file on one system might be a
594          completely legitimate data file on another system.
595
596   - RUNTESTFLAGS, CTAGSFLAGS, ETAGSFLAGS, JAVACFLAGS are no longer
597     defined by Automake.  This means that any definition in the
598     environment will be used, unless overridden in the Makefile.am or
599     on the command line.  The old behavior, where these variables were
600     defined empty in each Makefile, can be obtained by AC_SUBSTing or
601     AC_ARG_VARing each variable from configure.ac.
602
603   - CONFIGURE_DEPENDENCIES and CONFIG_STATUS_DEPENDENCIES are now
604     documented.  (The is not a new feature, these variables have
605     been there since at least Automake 1.4.)
606 \f
607 Bugs fixed in 1.7.9:
608 * Fix install-strip to work with nobase_ binaries.
609 * Fix renaming of #line directives in ylwrap.
610 * Rebuild with Autoconf 2.59.  (1.7.8 was not installable with pdksh.)
611 \f
612 Bugs fixed in 1.7.8:
613 * Remove spurious blank lines in cleaning rules introduced in 1.7.7.
614 * Fix detection of Debian's install-info, broken since version 1.5.
615   (Debian bug #213524).
616 * Honor -module if it appears in AM_LDFLAGS (i.e., relax name checking)
617   This was only done for libfoo_LDFLAGS and LDFLAGS in previous versions.
618 \f
619 Bugs fixed in 1.7.7:
620 * The implementation of automake's --no-force option is unreliable,
621   so this option is ignored in this version.  A real fix will appear in
622   Automake 1.8.  (Debian Bug #206299)
623 * AM_PATH_PYTHON: really check the whole list of interpreters if no
624   argument is given.  (PR/399)
625 * Do not warn about leading `_' in variable names, even with -Wportability.
626 * Support user redefinitions of TEXINFO_TEX.
627 * depcomp: support AIX Compiler version 6.
628 * Fix missing rebuilds during `make dist' with BSD make.
629   (Could produce tarballs containing out-of-date files.)
630 * Resurrect multilib support.
631 * Noteworthy manual updates:
632   - Extending aclocal: how to write m4 macros that won't trigger warnings
633     with Automake 1.8.
634   - A Shared Library: Rewrite and split into subsections.
635 \f
636 Bugs fixed in 1.7.6:
637 * Fix depcomp's icc mode for ICC 7.1.
638 * Diagnose calls to AC_CONFIG_FILES and friends with not enough arguments.
639 * Fix maintainer-clean's removal of autom4te.cache in VPATH builds.
640 * Fix AM_PATH_LISPDIR to work with POSIXLY_CORRECT=1.
641 * Fix the location reported in some diagnostics related to AUTOMAKE_OPTIONS.
642 * Remove Latin-1 characters from elisp-comp.
643 * Update the manual's @dircategory to match the Free Software Directory.
644 \f
645 Bugs fixed in 1.7.5:
646 * Update install-sh's license to remove an advertising clause.
647   (Debian bug #191717)
648 * Fix a bug introduced in 1.7.4, related to BUILT_SOURCE handling,
649   that caused invalid Makefile.ins to be generated.
650 * Make sure AM_MAKE_INCLUDE doesn't fail when a `doit' file exists.
651 * New FAQ entry: renamed objects.
652 \f
653 Bugs fixed in 1.7.4:
654 * Tweak the TAGS rule to support Exuberant Ctags (in addition to
655   the Emacs implementation)
656 * Fix output of aclocal.m4 dependencies in subdirectories.
657 * Use `mv -f' instead of `mv' in fastdep rules.
658 * Upgrade mdate-sh to work on OS/2.
659 * Don't byte-compile elisp files when ELCFILES is set empty.
660   (this documented feature was broken by 1.7.3)
661 * Diagnose trailing backslashes on last line of Makefile.am.
662 * Diagnose whitespace following trailing backslashes.
663 * Multiple tests are now correctly supported in DEJATOOL. (PR/388)
664 * Fix rebuilt rules for AC_CONFIG_FILES([Makefile:Makefile.in:Makefile.bot])
665   Makefiles. (PR/389)
666 * `make install' will build `BUILT_SOURCES' first.
667 * Minor documentation fixes.
668 \f
669 Bugs fixed in 1.7.3:
670 * Fix stamp files numbering (when using multiple AC_CONFIG_HEADERS).
671 * Query distutils for `pythondir' and `pythonexecdir', instead of
672   using an hardcoded path.  This should allow builds on 64-bit
673   distributions that usually use lib64/ instead of lib/.
674 * AM_PATH_PYTHON will also search for python2.3.
675 * elisp files are now built all at once instead of one by one. Besides
676   incurring a speed-up, this is required to support interdependent elisp files.
677 * Support for DJGPP:
678   - `make distcheck' will now work in `_inst/' and `_build' instead
679     of `=inst/' and `=build/'
680   - use `_dirstamp' when the file-system doesn't support `.dirstamp'
681   - install/uninstall `*.i[0-9][0-9]'-style info files
682   - more changes that affect only the Automake package (not its output)
683 * Fix some incompatibilities with upcoming perl-5.10.
684 * Properly quote AC_PACKAGE_TARNAME and AC_PACKAGE_VERSION when defining
685   PACKAGE and VERSION.
686 * depcomp fixes:
687   - dashmstdout and dashXmstdout modes: don't use `-o /dev/null', this
688     is troublesome with gcc and Solaris compilers. (PR/385)
689   - makedepend mode: work with Libtool. (PR/385 too)
690   - support for ICC.
691 * better support for unusual gettext setups, such as multiple po/ directories
692   (PR/381):
693   - Flag missing po/ and intl/ directories as warnings, not errors.
694   - Disable these warnings if po/ does not exist.
695 * Noteworthy manual updates:
696   - New FAQ chapter.
697   - Document how AC_CONFIG_AUX_DIR interacts with missing files.
698     (Debian Bug #39542)
699   - Document `AM_YFLAGS = -d'.  (PR/382)
700 \f
701 Bugs fixed in 1.7.2:
702 * Fix installation and uninstallation of Info files built in subdirectories.
703 * Do not run `./configure --with-included-gettext' during `make distcheck'
704   if AM_GNU_GETTEXT([external]) is used.
705 * Correctly uninstall renamed man pages.
706 * Do not strip escaped newline in variables defined in one condition
707   and augmented in another condition.
708 * Fix ansi2knr rules for LIBOBJS sources.
709 * Clean all known Texinfo index files, not only those which appear to
710   be used, because we cannot know wich indexes are used in included files.
711   (PR/375, Debian Bug #168671)
712 * Honor only the first @setfilename seen in a Texinfo file.
713 * Treat "required file X not found" diagnostics as errors (exit status 1).
714 * Don't complain that a required file is not found when it is a Makefile
715   target. (PR/357)
716 * Don't use single suffix inference rules when building `.info'-less
717   Info files, for the sake of Solaris make.
718 * The `check' target now depends on `$(BUILT_SOURCES)'. (PR/359)
719 * Recognize multiple inference rules such as `.a.b .c.d:'. (PR/371)
720 * Warn about multiple inference rules when -Wportability is used. (PR/372)
721 * Fix building of deansified files from subdirectories. (PR/370)
722 * Add missing `fi' in the .c->.obj rules.
723 * Improve install-sh to work even when names contain spaces or certain
724   (but not all) shell metachars.
725 * Fix the following spurious failures in the test suite:
726   depcomp2.test, gnits2.test, gnits3.test, python3.test, texinfo13.test
727 * Noteworthy manual updates:
728   - Augment the section about BUILT_SOURCES.
729   - Mention that AM_PROG_CC_STDC is a relic that is better avoided today.
730 \f
731 Bugs fixed in 1.7.1:
732 * Honor `ansi2knr' for files built in subdirectories, or using per-targets
733   flags.
734 * Aclocal should now recognize macro names containing parentheses, e.g.
735   AC_DEFUN([AC_LANG_PREPROC(Fortran 90)], [...]).
736 * Erase *.sum and *.log files created by DejaGnu, during `make distclean'.
737   (Debian Bug#153697)
738 * Install Python files even if they were built.  (PR/369)
739 * Have stamp-vti dependent upon configure instead of configure.ac, as the
740   version might not be defined in the latter. (PR/358)
741 * Reorder arguments passed to a couple of commands, so things works
742   when POSIXLY_CORRECT=1.
743 * Fix a regex that can cause Perl to segfault on large input.
744   (Debian Bug#162583)
745 * Fix distribution of packages that have some sources defined conditionally,
746   as in the `Conditional compilation using Automake conditionals' example
747   of the manual.
748 * Fix spurious test suite failures on IRIX.
749 * Don't report a required variable as undefined if it has been
750   defined conditionally for the "right" conditions.
751 * Fix cleaning of the /tmp subdirectory used by `make distcheck', in case
752   `make distcheck' fails.
753 * Fix distribution of included Makefile fragment, so we don't create
754   spurious directories in the distribution. (PR/366)
755 * Don't complain that a target lacks `.$(EXEEXT)' when it has it.
756 \f
757 New in 1.7:
758 * Autoconf 2.54 is required.
759 * `aclocal' and `automake' will no longer warn about obsolete
760   configure macros.  This is done by `autoconf -Wobsolete'.
761 * AM_CONFIG_HEADER, AM_SYS_POSIX_TERMIOS and
762   AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL are obsolete (although still
763   supported).  You should use AC_CONFIG_HEADERS, AC_SYS_POSIX_TERMIOS,
764   and AC_HEADER_TIOCGWINSZ instead.  `autoupdate' can upgrade
765   `configure.ac' for you.
766 * Support for per-program and per-library `_CPPFLAGS'.
767 * New `ctags' target (builds CTAGS files).
768 * Support for -Wmumble and -Wno-mumble, where mumble is a warning category
769   (see `automake --help' or the manual for a list of them).
770 * Honor the WARNINGS environment variable.
771 * Omit the call to depcomp when using gcc3: call the compiler directly.
772 * A new option, std-options, tests that programs support --help and --version
773   when `make installcheck' is run.  This is enabled by --gnits.
774 * Texinfo rules now support the `ps' and `pdf' targets.
775 * Info files are now created in the build directory, not the source directory.
776 * info_TEXINFOS supports files in subdirectories (this requires Texinfo 4.1
777   or greater).
778 * `make distcheck' will enforce DESTDIR support by attempting
779   a DESTDIR install.
780 * `+=' can be used in conditionals, even if the augmented variable
781   was defined for another condition.
782 * Makefile fragments (inserted with `include') are always distributed.
783 * Use Autoconf's --trace interface to inspect configure.ac and get
784   a more accurate view of it.
785 * Add support for extending aclocal's default macro search path
786   using a `dirlist' file within the aclocal directory.
787 * automake --output-dir is deprecated.
788 * The part of the distcheck target that checks whether uninstall actually
789   removes all installed files has been moved in a separate target,
790   distuninstallcheck, so it can be overridden easily.
791 * Many bug fixes.
792 \f
793 New in 1.6.3:
794 * Support for AM_INIT_GETTEXT([external])
795 * Bug fixes, including:
796   - Fix Automake's own `make install' so it works even if `ln' doesn't.
797   - nobase_ programs and scripts honor --program-transform correctly.
798   - Erase configure.lineno during `make distclean'.
799   - Erase YACC and LEX outputs during `make maintainer-clean'.
800 \f
801 New in 1.6.2:
802 * Many bug fixes, including:
803   - Requiring the current version works.
804   - Fix "$@" portability issues (for Zsh).
805   - Fix output of dummy dependency files in presence of post-processed
806     Makefile.in's.
807   - Don't compute dependencies in background to avoid races with libtool.
808   - Fix handling of _OBJECTS variables for targets sharing source variables.
809   - Check dependency mode for Java when AM_PROG_GCJ is used.
810 \f
811 New in 1.6.1:
812 * automake --output-dir is deprecated
813 * Many bug fixes, including:
814   - Don't choke on AM_LDFLAGS definitions.
815   - Clean libtool objects from subdirectories.
816   - Allow configure variables with reserved suffix and unknown prefix
817     (e.g. AC_SUBST(mumble_LDFLAGS) when 'mumble' is not a target).
818   - Fix the definition of AUTOMAKE and ACLOCAL in configure.
819 \f
820 New in 1.6:
821 * Autoconf 2.52 is required.
822 * automake no longer run libtoolize.
823   This is the job of autoreconf (from GNU Autoconf).
824 * `dist' generates all the archive flavors, as did `dist-all'.
825 * `dist-gzip' generates the Gzip tar file only.
826 * Combining Automake Makefile conditionals no longer lead to a combinatorial
827   explosion.  Makefile.in's keep a reasonable size.
828 * AM_FUNC_ERROR_AT_LINE, AM_FUNC_STRTOD, AM_FUNC_OBSTACK, AM_PTRDIFF_T
829   are no longer shipped, since Autoconf 2.52 provides them (both as AM_
830   and AC_).
831 * `#line' of Lex and Yacc files are properly set.
832 * EXTRA_DIST can contain generated directories.
833 * Support for dot-less extensions in suffix rules.
834 * The part of the distcheck target that checks whether distclean actually
835   cleans all built files has been moved in a separate target, distcleancheck,
836   so it can be overridden easily.
837 * `make distcheck' will pass additional options defined in
838   $(DISTCHECK_CONFIGURE_FLAGS) to configure.
839 * Fixed CDPATH portability problems, in particular for MacOS X.
840 * Fixed handling of nobase_ targets.
841 * Fixed support of implicit rules leading to .lo objects.
842 * Fixed late inclusion of --add-missing files (e.g. depcomp) in DIST_COMMON
843 * Added uninstall-hook target
844 * `AC_INIT AM_INIT_AUTOMAKE(tarname,version)' is an obsolete construct.
845   You can now use `AC_INIT(pkgname,version) AM_INIT_AUTOMAKE' instead.
846   (Note that "pkgname" is not "tarname", see the manual for details.)
847   It is also possible to pass a list of global Automake options as
848   first argument to this new form of AM_INIT_AUTOMAKE.
849 * Compiler-based assembler is now called `CCAS'; people expected `AS'
850   to be a real assembler.
851 * AM_INIT_AUTOMAKE will set STRIP itself when it needs it.  Adding
852   AC_CHECK_TOOL([STRIP], [strip]) manually is no longer required.
853 * aclocal and automake are also installed with the version number
854   appended, and some of the install directory names have changed.
855   This lets you have multiple versions installed simultaneously.
856 * Support for parsers and lexers in subdirectories.
857 \f
858 New in 1.5:
859 * Support for `configure.ac'.
860 * Support for `else COND', `endif COND' and negated conditions `!COND'.
861 * `make dist-all' is much faster.
862 * Allows '@' AC_SUBSTs in macro names.
863 * Faster AM_INIT_AUTOMAKE (requires update of `missing' script)
864 * User-side dependency tracking.  Developers no longer need GNU make
865 * Python support
866 * Uses DIST_SUBDIRS in some situations when SUBDIRS is conditional
867 * Most files are correctly handled if they appear in subdirs
868   For instance, a _DATA file can appear in a subdir
869 * GNU tar is no longer required for `make dist'
870 * Added support for `dist_' and `nodist_' prefixes
871 * Added support for `nobase_' prefix
872 * Compiled Java support
873 * Support for per-executable and per-library compilation flags
874 * Many bug fixes
875 \f
876 New in 1.4:
877 * Added support for the Fortran 77 programming language.
878 * Re-indexed the Automake Texinfo manual.
879 * Added `AM_FOOFLAGS' variable for each compiler invocation;
880   e.g. AM_CFLAGS can be used in Makefile.am to set C compiler flags
881 * Support for latest autoconf, including support for objext
882 * Can now put `.' in SUBDIRS to control build order
883 * `include' command and `+=' support for macro assignment
884 * Dependency tracking no long susceptible to deleted header file problem
885 * Maintainer mode now a conditional.  @MAINT@ is now an anachronism.
886 * Bug fixes
887 \f
888 New in 1.3:
889 * Bug fixes
890 * Better Cygwin32 support
891 * Support for suffix rules with _SOURCES variables
892 * New options `readme-alpha' and `check-news'; Gnits mode sets these
893 * @LEXLIB@ no longer required when lex source seen
894   Lex support in `missing', and new lex macro.  Update your missing script.
895 * Built-in support for assembly
896 * aclocal gives error if `AM_' macro not found
897 * Passed YFLAGS, not YACCFLAGS, to yacc
898 * AM_PROG_CC_STDC does not have to come before AC_PROG_CPP
899 * Dependencies computed as a side effect of compilation
900 * Preliminary support for Java
901 * DESTDIR support at "make install" time
902 * Improved ansi2knr support; you must use the latest ansi2knr.c (included)
903 \f
904 New in 1.2:
905 * Bug fixes
906 * Better DejaGnu support
907 * Added no-installinfo option
908 * Added Emacs Lisp support
909 * Added --no-force option
910 * Included `aclocal' program
911 * Automake will now generate rules to regenerate aclocal.m4, if appropriate
912 * Now uses `AM_' macro names everywhere
913 * ansi2knr option can have directory prefix (eg `../lib/ansi2knr')
914   ansi2knr now works correctly on K&R sources
915 * Better C++, yacc, lex support
916 * Will compute _DEPENDENCIES variables automatically if not supplied
917 * Will interpolate $(...) and ${...} when examining contents of a variable
918 * .deps files now in build directory, not source directory; dependency
919   handling generally rewritten
920 * DATA, MANS and BUILT_SOURCES no longer included in distribution
921 * can now put config.h into a subdir
922 * Added dist-all target
923 * Support for install-info program (see texinfo 3.9)
924 * Support for "yacc -d"
925 * configure substitutions are automatically discovered and included
926   in generated Makefile.in
927 * Special --cygnus mode
928 * OMIT_DEPENDENCIES can now hold list of dependencies to be omitted
929   when making distribution.  Some dependencies are auto-ignored.
930 * Changed how libraries are specified in _LIBRARIES variable
931 * Full libtool support, from Gord Matzigkeit
932 * No longer have to explicitly touch stamp-h when using AC_CONFIG_HEADER;
933   AM_CONFIG_HEADER handles it automatically
934 * Texinfo output files no longer need .info extension
935 * Added `missing' support
936 * Cygwin32 support
937 * Conditionals in Makefile.am, from Ian Taylor
938 \f
939 New in 1.0:
940 * Bug fixes
941 * distcheck target runs install and installcheck targets
942 * Added preliminary support for DejaGnu.
943 \f
944 New in 0.33:
945 * More bug fixes
946 * More checking
947 * More libtool fixes from Gord Matzigkeit; libtool support is still
948   preliminary however
949 * Added support for jm_MAINTAINER_MODE
950 * dist-zip support
951 * New "distcheck" target
952 \f
953 New in 0.32:
954 * Many bug fixes
955 * mkinstalldirs and mdate-sh now appear in directory specified by
956   AC_CONFIG_AUX_DIR.
957 * Removed DIST_SUBDIRS, DIST_OTHER
958 * AC_ARG_PROGRAM only required when an actual program exists
959 * dist-hook target now run before distribution packaged up; idea from
960   Dieter Baron.  Other hooks exist, too.
961 * Preliminary (unfinished) support for libtool
962 * Added short option names.
963 * Better "dist" support when gluing together multiple packages
964 \f
965 New in 0.31:
966 * Bug fixes
967 * Documentation updates (many from François Pinard)
968 * strictness `normal' now renamed to `foreign'
969 * Renamed --install-missing to --add-missing
970 * Now handles AC_CONFIG_AUX_DIR
971 * Now handles TESTS macro
972 * DIST_OTHER renamed to EXTRA_DIST
973 * DIST_SUBDIRS is deprecated
974 * @ALLOCA@ and @LIBOBJS@ now work in _LDADD variables
975 * Better error messages in many cases
976 * Program names are canonicalized
977 * Added "check" prefix; from Gord Matzigkeit
978 \f
979 New in 0.30:
980 * Bug fixes
981 * configure.in scanner knows about AC_PATH_XTRA, AC_OUTPUT ":" syntax
982 * Beginnings of a test suite
983 * Automatically adds -I options for $(srcdir), ".", and path to config.h
984 * Doesn't print anything when running
985 * Beginnings of MAINT_CHARSET support
986 * Can specify version in AUTOMAKE_OPTIONS
987 * Most errors recognizable by Emacs' M-x next-error
988 * Added --verbose option
989 * All "primary" variables now obsolete; use EXTRA_PRIMARY to supply
990   configure-generated names
991 * Required macros now distributed in aclocal.m4
992 * New documentation
993 * --strictness=gnu is default
994 \f
995 New in 0.29:
996 * Many bug fixes
997 * More sophisticated configure.in scanning; now understands ALLOCA and
998   LIBOBJS directly, handles AC_CONFIG_HEADER more precisely, etc.
999 * TEXINFOS and MANS now obsolete; use info_TEXINFOS and man_MANS instead.
1000 * CONFIG_HEADER variable now obsolete
1001 * Can handle multiple Texinfo sources
1002 * Allow hierarchies deeper than 2.  From Gord Matzigkeit.
1003 * HEADERS variable no longer needed; now can put .h files directly into
1004   foo_SOURCES variable.
1005 * Automake automatically rebuilds files listed in AC_OUTPUT.  The
1006   corresponding ".in" files are included in the distribution.
1007 \f
1008 New in 0.28:
1009 * Added --gnu and --gnits options
1010 * More standards checking
1011 * Bug fixes
1012 * Cleaned up 'dist' targets
1013 * Added AUTOMAKE_OPTIONS variable and several options
1014 * Now scans configure.in to get some information (preliminary)
1015 \f
1016 New in 0.27:
1017 * Works with Perl 4 again
1018 \f
1019 New in 0.26:
1020 * Added --install-missing option.
1021 * Pretty-prints generated macros and rules
1022 * Comments in Makefile.am are placed more intelligently in Makefile.in
1023 * Generates .PHONY target
1024 * Rule or macro in Makefile.am now overrides contents of Automake file
1025 * Substantial cleanups from François Pinard
1026 \f
1027 New in 0.25:
1028 * Bug fixes.
1029 * Works with Perl 4 again.
1030 \f
1031 New in 0.24:
1032 * New uniform naming scheme.
1033 * --strictness option
1034 * Works with Perl 5
1035 * '.c' files corresponding to '.y' or '.l' files are automatically
1036   distributed.
1037 * Many bug fixes and cleanups
1038 \f
1039 New in 0.23:
1040 * Allow objects to be conditionally included in libraries via lib_LIBADD.
1041 \f
1042 New in 0.22:
1043 * Bug fixes in 'clean' code.
1044 * Now generates 'installdirs' target.
1045 * man page installation reworked.
1046 * 'make dist' no longer re-creates all Makefile.in's.
1047 \f
1048 New in 0.21:
1049 * Reimplemented in Perl
1050 * Added --amdir option (for debugging)
1051 * Texinfo support cleaned up.
1052 * Automatic de-ANSI-fication cleaned up.
1053 * Cleaned up 'clean' targets.
1054 \f
1055 New in 0.20:
1056 * Automatic dependency tracking
1057 * More documentation
1058 * New variables DATA and PACKAGEDATA
1059 * SCRIPTS installed using $(INSTALL_SCRIPT)
1060 * No longer uses double-colon rules
1061 * Bug fixes
1062 * Changes in advance of internationalization
1063
1064 -----
1065
1066 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
1067 Free Software Foundation, Inc.
1068
1069 This file is part of GNU Automake.
1070
1071 GNU Automake is free software; you can redistribute it and/or modify
1072 it under the terms of the GNU General Public License as published by
1073 the Free Software Foundation; either version 2, or (at your option)
1074 any later version.
1075
1076 GNU Automake is distributed in the hope that it will be useful,
1077 but WITHOUT ANY WARRANTY; without even the implied warranty of
1078 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1079 GNU General Public License for more details.
1080
1081 You should have received a copy of the GNU General Public License
1082 along with GNU Automake; see the file COPYING.  If not, write to
1083 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
1084 Boston, MA 02111-1307, USA.