From: Stefano Lattarini Date: Tue, 20 Sep 2011 15:42:01 +0000 (+0200) Subject: docs: document planned precedence changes in aclocal search path X-Git-Tag: v1.11.1b~17^2~11^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2c57ac68468784a67c7ed8dced20cd5ac2b63e61;p=thirdparty%2Fautomake.git docs: document planned precedence changes in aclocal search path * doc/automake.texi (Macro Search Path): Explicitly state that the lookup order for extra directories of `.m4' files will be changed in the next major release. * NEWS: Likewise. --- diff --git a/ChangeLog b/ChangeLog index 278954484..05baf760b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2011-09-20 Stefano Lattarini + + docs: document planned precedence changes in aclocal search path + * doc/automake.texi (Macro Search Path): Explicitly state that the + lookup order for extra directories of `.m4' files will be changed + in the next major release. + * NEWS: Likewise. + 2011-09-19 Paolo Bonzini Stefano Lattarini diff --git a/NEWS b/NEWS index f9fa9594d..7ab3f07ce 100644 --- a/NEWS +++ b/NEWS @@ -8,6 +8,10 @@ New in 1.11.0a: - The `--acdir' option of aclocal is deprecated, and will probably be removed in the next major Automake release (1.12). + - The exact order in which the directories in the aclocal macro + search path are looked up is probably going to be changed in the + next Automake release (1.12). + * Changes to aclocal: - The `--acdir' option is deprecated. Now you should use th new options diff --git a/doc/automake.texi b/doc/automake.texi index 44778c3f1..18d29bec9 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -3455,6 +3455,16 @@ Conversely to @file{dirlist}, @env{ACLOCAL_PATH} is useful if you are using a global copy of Automake and want @command{aclocal} to look for macros somewhere under your home directory. +@subsubheading Planned future incompatibilities + +The order in which the directories in the macro search path are currently +looked up is confusing and/or suboptimal in various aspects, and is +probably going to be changed in the future Automake release. In +particular, directories in @env{ACLOCAL_PATH} and @file{@var{acdir}} +might end up taking precedence over @file{@var{acdir-APIVERSION}}, and +directories in @file{@var{acdir}/dirlist} might end up taking precedence +over @file{@var{acdir}}. @emph{This is a possible future incompatibility!} + @node Extending aclocal @subsection Writing your own aclocal macros