NEWS

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