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

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 <[email protected]>
Date:   Sat Sep 12 07:23:27 2009 -0600

    Track recent copyright assignments.
    
    * AUTHORS: Update.
    
    Signed-off-by: Eric Blake <[email protected]>

commit a30d5c4a22b36d3fe54e38441dfa02945ff96e60
Author: Eric Blake <[email protected]>
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 <[email protected]>

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

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              [email protected]                 2007-04-20
 Bob Proulx                  [email protected]                      2007-06-25
 Bruce Korb                  [email protected]                       2008-05-06
 Benjamin Pfaff              [email protected]                         2008-09-29
+Peter Breitenlohner         [email protected]                    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  <[email protected]>
+
+	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  <[email protected]>
 
 	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                  [email protected]
 Sam Sirlin                  [email protected]
 Sam Varshavchik             [email protected]
 Sander Niemeijer            [email protected]
+santilín                    [email protected]
 Scott Bambrough             [email protected]
 Scott Stanton               [email protected]
 Sebastian Freundt           [email protected]
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:
+
+@example
+echo "Hard rock was here!  --AC""_DC"
+AC_MSG_WARN([[AC@@&t@@_DC stinks  --Iron Maiden]])
+@end example
+
 You are now able to understand one of the constructs of Autoconf that
 has been continually misunderstood@enddots{}  The rule of thumb is that
 @emph{whenever you expect macro expansion, expect quote expansion};


hooks/post-receive
-- 
GNU Autoconf source repository