[SCM] GNU Autoconf source repository branch, master, updated. v2.69-103-gbefa527

[Eric Blake]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Autoconf source repository".

http://git.sv.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=befa52738c41e126cb9a5a7d4523912ed68b4e3a

The branch, master has been updated
       via  befa52738c41e126cb9a5a7d4523912ed68b4e3a (commit)
      from  63f3c78cdb0ccc85751543e387ef2a7252d5f0a2 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit befa52738c41e126cb9a5a7d4523912ed68b4e3a
Author: Eric Blake <address@hidden>
Date:   Thu Sep 5 14:14:55 2013 -0600

    doc: mention how to set early defaults
    
    Jonathan Lebon reported an issue to me off-list about a regression
    in libvirt's configure script, which I traced to a patch that
    rearranged code that was checking $with_library compared to the
    AC_ARG_WITH that actually set $with_library [1].  As the whole point
    of the libvirt patch was to refactor code to make maintenance
    easier by hiding the AC_ARG_WITH in a helper macro for a net
    reduction in lines, it makes sense to actually document how to
    check what value a variable has prior to the AC_ARG_WITH usage.
    
    Alas, although the functionality for this has been present in
    autoconf for ages, the documentation has been lacking.
    
    [1] libvirt.org/git/?p=libvirt.git;a=commitdiff;h=654c709
    
    * doc/autoconf.texi (Diversion support) <m4_divert_text>: Add
    anchor.
    (External Software) <AC_ARG_WITH>: Demonstrate how to use DEFAULTS
    diversion, for earlier defaults.
    (Package Options) <AC_ARG_ENABLE>: Likewise.
    * THANKS: Add Jonathan Lebon.
    
    Signed-off-by: Eric Blake <address@hidden>

-----------------------------------------------------------------------

Summary of changes:
 THANKS            |    1 +
 doc/autoconf.texi |   19 ++++++++++++++++++-
 2 files changed, 19 insertions(+), 1 deletions(-)

diff --git a/THANKS b/THANKS
index 1e3e5ef..f41f16c 100644
--- a/THANKS
+++ b/THANKS
@@ -210,6 +210,7 @@ John Interrante             address@hidden
 John R. Cary                address@hidden
 John W. Eaton               address@hidden
 Jonathan Kamens             address@hidden
+Jonathan Lebon              address@hidden
 Josef Tran                  address@hidden
 Josef Vukovic               address@hidden
 Joseph S. Myers             address@hidden
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 3c559a5..26e7b17 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -11997,6 +11997,7 @@ stack, and issues an error if there is not a matching 
pop for every
 push.
 @end defmac
 
address@hidden
 @defmac m4_divert_text (@var{diversion}, @ovar{content})
 @msindex{divert_text}
 Output @var{content} and a newline into @var{diversion}, without
@@ -22085,6 +22086,14 @@ actually just the value of the shell variable named
 @var{package} changed into @samp{_}.  You may use that variable instead,
 if you wish.
 
+Note that @var{action-if-not-given} is not expanded until the point that
address@hidden was expanded.  If you need the value of
address@hidden@var{package}} set to a default value by the time argument
+parsing is completed, use @code{m4_divert_text} to the @code{DEFAULTS}
+diversion (@pxref{m4_divert_text}) (if done as an argument to
address@hidden, also provide non-diverted text to avoid a shell
+syntax error).
+
 The argument @var{help-string} is a description of the option that
 looks like this:
 @example
@@ -22111,7 +22120,7 @@ AC_ARG_WITH([readline],
   [AS_HELP_STRING([--with-readline],
     [support fancy command line editing @@<:@@default=check@@:>@@])],
   [],
-  [with_readline=check])
+  [: m4_divert_text([DEFAULTS], [with_readline=check])])
 
 LIBREADLINE=
 AS_IF([test "x$with_readline" != xno],
@@ -22238,6 +22247,14 @@ actually just the value of the shell variable named
 if you wish.  The @var{help-string} argument is like that of
 @code{AC_ARG_WITH} (@pxref{External Software}).
 
+Note that @var{action-if-not-given} is not expanded until the point that
address@hidden was expanded.  If you need the value of
address@hidden@var{feature}} set to a default value by the time argument
+parsing is completed, use @code{m4_divert_text} to the @code{DEFAULTS}
+diversion (@pxref{m4_divert_text}) (if done as an argument to
address@hidden, also provide non-diverted text to avoid a shell
+syntax error).
+
 You should format your @var{help-string} with the macro
 @code{AS_HELP_STRING} (@pxref{Pretty Help Strings}).
 


hooks/post-receive
-- 
GNU Autoconf source repository