[SCM] GNU Autoconf source repository branch, master, updated. v2.64-35-g0ccf0c1

[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=0ccf0c1022a6b8f38945b47327f1fbfbd0b81804

The branch, master has been updated
       via  0ccf0c1022a6b8f38945b47327f1fbfbd0b81804 (commit)
       via  a30d5c4a22b36d3fe54e38441dfa02945ff96e60 (commit)
      from  bb09823ea70b0468852ba0e8c2b288eddd406a80 (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 0ccf0c1022a6b8f38945b47327f1fbfbd0b81804
Author: Eric Blake <address@hidden>
Date:   Sat Sep 12 07:23:27 2009 -0600

    Track recent copyright assignments.
    
    * AUTHORS: Update.
    
    Signed-off-by: Eric Blake <address@hidden>

commit a30d5c4a22b36d3fe54e38441dfa02945ff96e60
Author: Eric Blake <address@hidden>
Date:   Thu Sep 10 20:47:50 2009 -0600

    Improve documentation on quoting.
    
    * doc/autoconf.texi (Autoconf Language): Clarify quoting example.
    * THANKS: Update.
    Reported by santilín.
    
    Signed-off-by: Eric Blake <address@hidden>

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

Summary of changes:
 AUTHORS           |    1 +
 ChangeLog         |   10 ++++++++++
 THANKS            |    1 +
 doc/autoconf.texi |   23 ++++++++++++++++++++---
 4 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/AUTHORS b/AUTHORS
index 09854ed..e9fd384 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -92,6 +92,7 @@ Benoit Sigoure              address@hidden                 
2007-04-20
 Bob Proulx                  address@hidden                      2007-06-25
 Bruce Korb                  address@hidden                       2008-05-06
 Benjamin Pfaff              address@hidden                         2008-09-29
+Peter Breitenlohner         address@hidden                    2009-08-18
 
 ========================================================================
 
diff --git a/ChangeLog b/ChangeLog
index af08473..9173cb3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2009-09-12  Eric Blake  <address@hidden>
+
+       Track recent copyright assignments.
+       * AUTHORS: Update.
+
+       Improve documentation on quoting.
+       * doc/autoconf.texi (Autoconf Language): Clarify quoting example.
+       * THANKS: Update.
+       Reported by santilín.
+
 2009-09-11  Ralf Wildenhues  <address@hidden>
 
        New config.status option --config.
diff --git a/THANKS b/THANKS
index 0901d6a..4a96e34 100644
--- a/THANKS
+++ b/THANKS
@@ -327,6 +327,7 @@ Sam Sexton                  address@hidden
 Sam Sirlin                  address@hidden
 Sam Varshavchik             address@hidden
 Sander Niemeijer            address@hidden
+santilín                    address@hidden
 Scott Bambrough             address@hidden
 Scott Stanton               address@hidden
 Sebastian Freundt           address@hidden
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 098d512..4764559 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -1177,29 +1177,46 @@ AC_CHECK_HEADER(stdio.h,
 
 In other cases, you may have to use text that also resembles a macro
 call.  You must quote that text even when it is not passed as a macro
-argument:
+argument.  For example, these two approaches in @file{configure.ac}
+(quoting just the potential problems, or quoting the entire line) will
+protect your script in case autoconf ever adds a macro @code{AC_DC}:
 
 @example
 echo "Hard rock was here!  --[AC_DC]"
+[echo "Hard rock was here!  --AC_DC"]
 @end example
 
 @noindent
-which results in:
+which results in this text in @file{configure}:
 
 @example
 echo "Hard rock was here!  --AC_DC"
+echo "Hard rock was here!  --AC_DC"
 @end example
 
 @noindent
 When you use the same text in a macro argument, you must therefore have
 an extra quotation level (since one is stripped away by the macro
 substitution).  In general, then, it is a good idea to @emph{use double
-quoting for all literal string arguments}:
+quoting for all literal string arguments}, either around just the
+problematic portions, or over the entire argument:
 
 @example
+AC_MSG_WARN([[AC_DC] stinks  --Iron Maiden])
 AC_MSG_WARN([[AC_DC stinks  --Iron Maiden]])
 @end example
 
+However, the above example triggers a warning about a possibly
+unexpanded macro when running @command{autoconf}, because it collides
+with the namespace of macros reserved for the Autoconf language.  To be
+really safe, you can use additional escaping (either a quadrigraph, or
+creative shell constructs) to silence that particular warning:
+
address@hidden
+echo "Hard rock was here!  --AC""_DC"
+AC_MSG_WARN([[AC@@&t@@_DC stinks  --Iron Maiden]])
address@hidden example
+
 You are now able to understand one of the constructs of Autoconf that
 has been continually address@hidden  The rule of thumb is that
 @emph{whenever you expect macro expansion, expect quote expansion};


hooks/post-receive
-- 
GNU Autoconf source repository