NEWS

   1 New in 1.7a:
   2
   3 * Meta-News
   4
   5   - The NEWS file is more verbose.
   6
   7 * Requirements
   8
   9   - Autoconf 2.57b or greater is required.
  10
  11 * New features
  12
  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.
  17
  18   - New warning option: -Woverride.  This will warn about any user
  19     target or variable definitions which override Automake
  20     definitions.
  21
  22   - Texinfo rules back up and restore info files when makeinfo fails.
  23
  24   - Texinfo rules now support the `html' target.
  25     Running this requires Texinfo 4.0 or greater.
  26
  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.
  35
  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.
  39
  40   - Any file which is m4_included from configure.ac will appear as a
  41     configure and Makefile.in dependency, and will be automatically
  42     distributed.
  43
  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.
  53
  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
  59     AC_SUBST.
  60
  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.)
  64
  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.)
  69
  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.
  73
  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
  77     conditionally.
  78
  79   - New option no-dist-gzip.
  80
  81   - install-sh now understands --version and --help.
  82
  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
  85     distributions.
  86
  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
  89     (which is to abort).
  90
  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
  96     these tools.
  97
  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
 101     files.)
 102
 103 * Obsolete features
 104
 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
 108     longer documented.
 109
 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.)
 116
 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
 123     -Wobsolete'.
 124
 125 * Bug fixes
 126
 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
 130     conditions.
 131
 132       bin_PROGRAMS = a
 133       if COND1
 134         bin_PROGRAMS += a1
 135       endif
 136       if COND2
 137         bin_PROGRAMS += a2
 138       endif
 139       if COND3
 140         bin_PROGRAMS += a3
 141       endif
 142       ...
 143
 144     Likewise for _SOURCES, _LDADD, and _LIBADD variables.
 145
 146   - Automake now supports bin_PROGRAMS (or any *_PROGRAMS variable)
 147     being defined in several conditions.  As in
 148
 149       if COND1
 150         bin_PROGRAMS = a1
 151       endif
 152       if COND2
 153         bin_PROGRAMS = a2
 154       endif
 155
 156     Likewise for _SOURCES, _LDADD, and _LIBADD variables.
 157
 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
 164     `make dist'.
 165
 166   - The --no-force option now correctly checks the Makefile.in's
 167     dependencies before deciding not to update it.
 168
 169   - Do not assume that make files are called Makefile in cleaning rules.
 170
 171 * Miscellaneous
 172
 173   - The Automake manual is now distributed under the terms of the GNU FDL.
 174
 175   - Targets dist-gzip, dist-bzip2, dist-tarZ, dist-zip are always defined.
 176
 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.
 188
 189 \f
 190 New in 1.7:
 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
 210   or greater).
 211 * `make distcheck' will enforce DESTDIR support by attempting
 212   a DESTDIR install.
 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.
 224 * Many bug fixes.
 225 \f
 226 New in 1.6:
 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_
 236   and AC_).
 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.
 263 \f
 264 New in 1.5:
 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
 271 * Python support
 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
 280 * Many bug fixes
 281 \f
 282 New in 1.4:
 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.
 292 * Bug fixes
 293 \f
 294 New in 1.3:
 295 * Bug fixes
 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)
 309 \f
 310 New in 1.2:
 311 * Bug fixes
 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
 342 * Cygwin32 support
 343 * Conditionals in Makefile.am, from Ian Taylor
 344 \f
 345 New in 1.0:
 346 * Bug fixes
 347 * distcheck target runs install and installcheck targets
 348 * Added preliminary support for DejaGnu.
 349 \f
 350 New in 0.33:
 351 * More bug fixes
 352 * More checking
 353 * More libtool fixes from Gord Matzigkeit; libtool support is still
 354   preliminary however
 355 * Added support for jm_MAINTAINER_MODE
 356 * dist-zip support
 357 * New "distcheck" target
 358 \f
 359 New in 0.32:
 360 * Many bug fixes
 361 * mkinstalldirs and mdate-sh now appear in directory specified by
 362   AC_CONFIG_AUX_DIR.
 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
 370 \f
 371 New in 0.31:
 372 * Bug fixes
 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
 384 \f
 385 New in 0.30:
 386 * Bug fixes
 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
 398 * New documentation
 399 * --strictness=gnu is default
 400 \f
 401 New in 0.29:
 402 * Many bug fixes
 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.
 413 \f
 414 New in 0.28:
 415 * Added --gnu and --gnits options
 416 * More standards checking
 417 * Bug fixes
 418 * Cleaned up 'dist' targets
 419 * Added AUTOMAKE_OPTIONS variable and several options
 420 * Now scans configure.in to get some information (preliminary)
 421 \f
 422 New in 0.27:
 423 * Works with Perl 4 again
 424 \f
 425 New in 0.26:
 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
 432 \f
 433 New in 0.25:
 434 * Bug fixes.
 435 * Works with Perl 4 again.
 436 \f
 437 New in 0.24:
 438 * New uniform naming scheme.
 439 * --strictness option
 440 * Works with Perl 5
 441 * '.c' files corresponding to '.y' or '.l' files are automatically
 442   distributed.
 443 * Many bug fixes and cleanups
 444 \f
 445 New in 0.23:
 446 * Allow objects to be conditionally included in libraries via lib_LIBADD.
 447 \f
 448 New in 0.22:
 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.
 453 \f
 454 New in 0.21:
 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.
 460 \f
 461 New in 0.20:
 462 * Automatic dependency tracking
 463 * More documentation
 464 * New variables DATA and PACKAGEDATA
 465 * SCRIPTS installed using $(INSTALL_SCRIPT)
 466 * No longer uses double-colon rules
 467 * Bug fixes
 468 * Changes in advance of internationalization
 469
 470 -----
 471
 472 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
 473 Free Software Foundation, Inc.
 474
 475 This file is part of GNU Automake.
 476
 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)
 480 any later version.
 481
 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.
 486
 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.