5 - The NEWS file is more verbose.
9 - Autoconf 2.57b or greater is required.
13 - AR's `cru' flags are now set in a global ARFLAGS variable instead
14 of being hard-coded in each $(AR) invocation, so they can be
15 substituted from configure.ac. This has been requested by people
16 dealing with non-POSIX ar implementations.
18 - New warning option: -Woverride. This will warn about any user
19 target or variable definitions which override Automake
22 - Texinfo rules back up and restore info files when makeinfo fails.
24 - Texinfo rules now support the `html' target.
25 Running this requires Texinfo 4.0 or greater.
27 `html' is a new recursive target, so if your package mixes
28 hand-crafted `Makefile.in's with Automake-generated
29 `Makefile.in's, you should adjust the former to support (or
30 ignore) this target so that `make html' recurses successfully. If
31 you had a custom `html' rule in your `Makefile.am', it's better to
32 rename it as `html-local', otherwise your rule will override
33 Automake's new rule (you can check that by running `automake
34 -Woverride') and that will stop the recursion to subdirectories.
36 Last but not least, this `html' rule is declared PHONY, even when
37 overridden. Fortunately, it appears that few packages use a
38 non-PHONY `html' rule.
40 - Any file which is m4_included from configure.ac will appear as a
41 configure and Makefile.in dependency, and will be automatically
44 - The rules for rebuilding Makefiles and Makefile.ins will now
45 rebuild all Makefiles and all Makefile.ins at once when one of
46 configure's dependencies has changed. This is considerably faster
47 than previous implementations, where config.status and automake
48 were run separately in each directory (this still happens when you
49 change a Makefile.am locally, without touching configure.ac or
50 friends). Doing this also solves a longstanding issue: these
51 rebuild rules failed to work when adding new directories to the
52 tree, forcing you to run automake manually.
54 - For similar reasons, the rules to rebuild configure,
55 config.status, and aclocal.m4 are now defined in all directories.
56 Note that if you were using the CONFIG_STATUS_DEPENDENCIES and
57 CONFIGURE_DEPENDENCIES (undocumented) variables, you should better
58 define them in all directories. This is easily done using an
61 - aclocal will now use `m4_include' instead of copying local m4
62 files into aclocal.m4. (Local m4 files are those you ship with
63 your project, other files will be copied as usual.)
65 Because m4_included files are automatically distributed, it means
66 for most projects there is no point in EXTRA_DISTing the list of
67 m4 files which are used. (You can probably get rid of
68 m4/Makefile.am if you had one.)
70 - aclocal will avoid touching aclocal.m4 when possible, so that
71 Autom4te's cache isn't needlessly invalidated. This behavior can
72 be switched off with the new `--force' option.
74 - aclocal now uses Autoconf's --trace to detect macros which are actually
75 used and will no longer include unused macros simply because they
76 where mentioned. This was often the case for macros called
79 - New option no-dist-gzip.
81 - install-sh now understands --version and --help.
83 - Automake will now recognize AC_CONFIG_LINKS so far as removing created
84 links as part of the distclean target and including source files in
87 - AM_PATH_PYTHON now support ACTION-IF-FOUND and ACTION-IF-NOT-FOUND
88 argument. The latter can be used to override the default behavior
91 - Automake will exit with $? = 63 on version mismatch. (So does
92 Autoconf 2.58) missing knows this, and in this case it will
93 emulate the tools as if they were absent. Because older versions
94 of Automake and Autoconf did not use this exit code, this change
95 will only be useful in projects generated with future versions of
98 - When using AC_CONFIG_FILES with multiple input files, Automake
99 generates the first ".in" input file for which a ".am" exists.
100 (Former versions would try to use only the first of the input
105 - lisp_DATA is now allowed. If you are using the empty ELCFILES
106 idiom to disable byte-compilation of lisp_LISP files, it is
107 recommended that you switch to using lisp_DATA. ELCFILES is no
110 - AM_PROG_CC_STDC is now empty. The content of this macro was
111 merged in AC_PROG_CC. If your code uses $am_cv_prog_cc_stdc, you
112 should adjust it to use $ac_cv_prog_cc_stdc instead. (This
113 renaming should be safe, even if you have to support several,
114 versions of Automake, because AC_PROG_CC defines this variable
115 since Autoconf 2.54.)
117 - Some users where using the undocumented ACLOCAL_M4_SOURCES
118 variable to override the aclocal.m4 dependencies computed
119 (inaccurately) by older versions of Automake. Because Automake
120 now tracks configure's m4 dependencies accurately (see m4_include
121 above), the use of ACLOCAL_M4_SOURCES should be considered
122 obsolete and will be flagged as such when running `automake
127 - Defining programs conditionally using Automake conditionals no
128 longer leads to a combinatorial explosion. The following
129 construct used to be troublesome when used with dozens of
144 Likewise for _SOURCES, _LDADD, and _LIBADD variables.
146 - Automake now supports bin_PROGRAMS (or any *_PROGRAMS variable)
147 being defined in several conditions. As in
156 Likewise for _SOURCES, _LDADD, and _LIBADD variables.
158 - Cleanup the definitions of $(distdir) and $(top_distdir).
159 $(top_distdir) now points to the root of the distribution
160 directory created during `make dist', as it did in Automake 1.4,
161 not to the root of the build tree as it did in intervening
162 versions. Furthermore these two variables are now only defined in
163 the top level Makefile, and passed to sub-directories when running
166 - The --no-force option now correctly checks the Makefile.in's
167 dependencies before deciding not to update it.
169 - Do not assume that make files are called Makefile in cleaning rules.
173 - The Automake manual is now distributed under the terms of the GNU FDL.
175 - Targets dist-gzip, dist-bzip2, dist-tarZ, dist-zip are always defined.
177 - core dumps are no longer removed by the cleaning rules. There are
178 at least three reasons for this:
179 1. These files should not be created by any build step,
180 so their removal do not fit any of the cleaning rules.
181 Actually, they may be precious to the developer.
182 2. If such file is created during a build, then it's clearly a
183 bug Automake should not hide. Not removing the file will
184 cause `make distcheck' to complain about its presence.
185 3. Operating systems have different naming conventions for
186 core dump files. A core file on one system might be a
187 completely legitimate data file on another system.
191 * Autoconf 2.54 is required.
192 * `aclocal' and `automake' will no longer warn about obsolete
193 configure macros. This is done by `autoconf -Wobsolete'.
194 * AM_CONFIG_HEADER, AM_SYS_POSIX_TERMIOS and
195 AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL are obsolete (although still
196 supported). You should use AC_CONFIG_HEADERS, AC_SYS_POSIX_TERMIOS,
197 and AC_HEADER_TIOCGWINSZ instead. `autoupdate' can upgrade
198 `configure.ac' for you.
199 * Support for per-program and per-library `_CPPFLAGS'.
200 * New `ctags' target (builds CTAGS files).
201 * Support for -Wmumble and -Wno-mumble, where mumble is a warning category
202 (see `automake --help' or the manual for a list of them).
203 * Honor the WARNINGS environment variable.
204 * Omit the call to depcomp when using gcc3: call the compiler directly.
205 * A new option, std-options, tests that programs support --help and --version
206 when `make installcheck' is run. This is enabled by --gnits.
207 * Texinfo rules now support the `ps' and `pdf' targets.
208 * Info files are now created in the build directory, not the source directory.
209 * info_TEXINFOS supports files in subdirectories (this requires Texinfo 4.1
211 * `make distcheck' will enforce DESTDIR support by attempting
213 * `+=' can be used in conditionals, even if the augmented variable
214 was defined for another condition.
215 * Makefile fragments (inserted with `include') are always distributed.
216 * Use Autoconf's --trace interface to inspect configure.ac and get
217 a more accurate view of it.
218 * Add support for extending aclocal's default macro search path
219 using a `dirlist' file within the aclocal directory.
220 * automake --output-dir is deprecated.
221 * The part of the distcheck target that checks whether uninstall actually
222 removes all installed files has been moved in a separate target,
223 distuninstallcheck, so it can be overridden easily.
227 * Autoconf 2.52 is required.
228 * automake no longer run libtoolize.
229 This is the job of autoreconf (from GNU Autoconf).
230 * `dist' generates all the archive flavors, as did `dist-all'.
231 * `dist-gzip' generates the Gzip tar file only.
232 * Combining Automake Makefile conditionals no longer lead to a combinatorial
233 explosion. Makefile.in's keep a reasonable size.
234 * AM_FUNC_ERROR_AT_LINE, AM_FUNC_STRTOD, AM_FUNC_OBSTACK, AM_PTRDIFF_T
235 are no longer shipped, since Autoconf 2.52 provides them (both as AM_
237 * `#line' of Lex and Yacc files are properly set.
238 * EXTRA_DIST can contain generated directories.
239 * Support for dot-less extensions in suffix rules.
240 * The part of the distcheck target that checks whether distclean actually
241 cleans all built files has been moved in a separate target, distcleancheck,
242 so it can be overridden easily.
243 * `make distcheck' will pass additional options defined in
244 $(DISTCHECK_CONFIGURE_FLAGS) to configure.
245 * Fixed CDPATH portability problems, in particular for MacOS X.
246 * Fixed handling of nobase_ targets.
247 * Fixed support of implicit rules leading to .lo objects.
248 * Fixed late inclusion of --add-missing files (e.g. depcomp) in DIST_COMMON
249 * Added uninstall-hook target
250 * `AC_INIT AM_INIT_AUTOMAKE(tarname,version)' is an obsolete construct.
251 You can now use `AC_INIT(pkgname,version) AM_INIT_AUTOMAKE' instead.
252 (Note that "pkgname" is not "tarname", see the manual for details.)
253 It is also possible to pass a list of global Automake options as
254 first argument to this new form of AM_INIT_AUTOMAKE.
255 * Compiler-based assembler is now called `CCAS'; people expected `AS'
256 to be a real assembler.
257 * AM_INIT_AUTOMAKE will set STRIP itself when it needs it. Adding
258 AC_CHECK_TOOL([STRIP], [strip]) manually is no longer required.
259 * aclocal and automake are also installed with the version number
260 appended, and some of the install directory names have changed.
261 This lets you have multiple versions installed simultaneously.
262 * Support for parsers and lexers in subdirectories.
265 * Support for `configure.ac'.
266 * Support for `else COND', `endif COND' and negated conditions `!COND'.
267 * `make dist-all' is much faster.
268 * Allows '@' AC_SUBSTs in macro names.
269 * Faster AM_INIT_AUTOMAKE (requires update of `missing' script)
270 * User-side dependency tracking. Developers no longer need GNU make
272 * Uses DIST_SUBDIRS in some situations when SUBDIRS is conditional
273 * Most files are correctly handled if they appear in subdirs
274 For instance, a _DATA file can appear in a subdir
275 * GNU tar is no longer required for `make dist'
276 * Added support for `dist_' and `nodist_' prefixes
277 * Added support for `nobase_' prefix
278 * Compiled Java support
279 * Support for per-executable and per-library compilation flags
283 * Added support for the Fortran 77 programming language.
284 * Re-indexed the Automake Texinfo manual.
285 * Added `AM_FOOFLAGS' variable for each compiler invocation;
286 e.g. AM_CFLAGS can be used in Makefile.am to set C compiler flags
287 * Support for latest autoconf, including support for objext
288 * Can now put `.' in SUBDIRS to control build order
289 * `include' command and `+=' support for macro assignment
290 * Dependency tracking no long susceptible to deleted header file problem
291 * Maintainer mode now a conditional. @MAINT@ is now an anachronism.
296 * Better Cygwin32 support
297 * Support for suffix rules with _SOURCES variables
298 * New options `readme-alpha' and `check-news'; Gnits mode sets these
299 * @LEXLIB@ no longer required when lex source seen
300 Lex support in `missing', and new lex macro. Update your missing script.
301 * Built-in support for assembly
302 * aclocal gives error if `AM_' macro not found
303 * Passed YFLAGS, not YACCFLAGS, to yacc
304 * AM_PROG_CC_STDC does not have to come before AC_PROG_CPP
305 * Dependencies computed as a side effect of compilation
306 * Preliminary support for Java
307 * DESTDIR support at "make install" time
308 * Improved ansi2knr support; you must use the latest ansi2knr.c (included)
312 * Better DejaGnu support
313 * Added no-installinfo option
314 * Added Emacs Lisp support
315 * Added --no-force option
316 * Included `aclocal' program
317 * Automake will now generate rules to regenerate aclocal.m4, if appropriate
318 * Now uses `AM_' macro names everywhere
319 * ansi2knr option can have directory prefix (eg `../lib/ansi2knr')
320 ansi2knr now works correctly on K&R sources
321 * Better C++, yacc, lex support
322 * Will compute _DEPENDENCIES variables automatically if not supplied
323 * Will interpolate $(...) and ${...} when examining contents of a variable
324 * .deps files now in build directory, not source directory; dependency
325 handling generally rewritten
326 * DATA, MANS and BUILT_SOURCES no longer included in distribution
327 * can now put config.h into a subdir
328 * Added dist-all target
329 * Support for install-info program (see texinfo 3.9)
330 * Support for "yacc -d"
331 * configure substitutions are automatically discovered and included
332 in generated Makefile.in
333 * Special --cygnus mode
334 * OMIT_DEPENDENCIES can now hold list of dependencies to be omitted
335 when making distribution. Some dependencies are auto-ignored.
336 * Changed how libraries are specified in _LIBRARIES variable
337 * Full libtool support, from Gord Matzigkeit
338 * No longer have to explicitly touch stamp-h when using AC_CONFIG_HEADER;
339 AM_CONFIG_HEADER handles it automatically
340 * Texinfo output files no longer need .info extension
341 * Added `missing' support
343 * Conditionals in Makefile.am, from Ian Taylor
347 * distcheck target runs install and installcheck targets
348 * Added preliminary support for DejaGnu.
353 * More libtool fixes from Gord Matzigkeit; libtool support is still
355 * Added support for jm_MAINTAINER_MODE
357 * New "distcheck" target
361 * mkinstalldirs and mdate-sh now appear in directory specified by
363 * Removed DIST_SUBDIRS, DIST_OTHER
364 * AC_ARG_PROGRAM only required when an actual program exists
365 * dist-hook target now run before distribution packaged up; idea from
366 Dieter Baron. Other hooks exist, too.
367 * Preliminary (unfinished) support for libtool
368 * Added short option names.
369 * Better "dist" support when gluing together multiple packages
373 * Documentation updates (many from François Pinard)
374 * strictness `normal' now renamed to `foreign'
375 * Renamed --install-missing to --add-missing
376 * Now handles AC_CONFIG_AUX_DIR
377 * Now handles TESTS macro
378 * DIST_OTHER renamed to EXTRA_DIST
379 * DIST_SUBDIRS is deprecated
380 * @ALLOCA@ and @LIBOBJS@ now work in _LDADD variables
381 * Better error messages in many cases
382 * Program names are canonicalized
383 * Added "check" prefix; from Gord Matzigkeit
387 * configure.in scanner knows about AC_PATH_XTRA, AC_OUTPUT ":" syntax
388 * Beginnings of a test suite
389 * Automatically adds -I options for $(srcdir), ".", and path to config.h
390 * Doesn't print anything when running
391 * Beginnings of MAINT_CHARSET support
392 * Can specify version in AUTOMAKE_OPTIONS
393 * Most errors recognizable by Emacs' M-x next-error
394 * Added --verbose option
395 * All "primary" variables now obsolete; use EXTRA_PRIMARY to supply
396 configure-generated names
397 * Required macros now distributed in aclocal.m4
399 * --strictness=gnu is default
403 * More sophisticated configure.in scanning; now understands ALLOCA and
404 LIBOBJS directly, handles AC_CONFIG_HEADER more precisely, etc.
405 * TEXINFOS and MANS now obsolete; use info_TEXINFOS and man_MANS instead.
406 * CONFIG_HEADER variable now obsolete
407 * Can handle multiple Texinfo sources
408 * Allow hierarchies deeper than 2. From Gord Matzigkeit.
409 * HEADERS variable no longer needed; now can put .h files directly into
410 foo_SOURCES variable.
411 * Automake automatically rebuilds files listed in AC_OUTPUT. The
412 corresponding ".in" files are included in the distribution.
415 * Added --gnu and --gnits options
416 * More standards checking
418 * Cleaned up 'dist' targets
419 * Added AUTOMAKE_OPTIONS variable and several options
420 * Now scans configure.in to get some information (preliminary)
423 * Works with Perl 4 again
426 * Added --install-missing option.
427 * Pretty-prints generated macros and rules
428 * Comments in Makefile.am are placed more intelligently in Makefile.in
429 * Generates .PHONY target
430 * Rule or macro in Makefile.am now overrides contents of Automake file
431 * Substantial cleanups from François Pinard
435 * Works with Perl 4 again.
438 * New uniform naming scheme.
439 * --strictness option
441 * '.c' files corresponding to '.y' or '.l' files are automatically
443 * Many bug fixes and cleanups
446 * Allow objects to be conditionally included in libraries via lib_LIBADD.
449 * Bug fixes in 'clean' code.
450 * Now generates 'installdirs' target.
451 * man page installation reworked.
452 * 'make dist' no longer re-creates all Makefile.in's.
455 * Reimplemented in Perl
456 * Added --amdir option (for debugging)
457 * Texinfo support cleaned up.
458 * Automatic de-ANSI-fication cleaned up.
459 * Cleaned up 'clean' targets.
462 * Automatic dependency tracking
464 * New variables DATA and PACKAGEDATA
465 * SCRIPTS installed using $(INSTALL_SCRIPT)
466 * No longer uses double-colon rules
468 * Changes in advance of internationalization
472 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
473 Free Software Foundation, Inc.
475 This file is part of GNU Automake.
477 GNU Automake is free software; you can redistribute it and/or modify
478 it under the terms of the GNU General Public License as published by
479 the Free Software Foundation; either version 2, or (at your option)
482 GNU Automake is distributed in the hope that it will be useful,
483 but WITHOUT ANY WARRANTY; without even the implied warranty of
484 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
485 GNU General Public License for more details.
487 You should have received a copy of the GNU General Public License
488 along with GNU Automake; see the file COPYING. If not, write to
489 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
490 Boston, MA 02111-1307, USA.