[SCM] GNU Autoconf source repository branch, master, updated. v2.63b-97-gbd9c233

[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=bd9c233305b0abc867eea1deddde55be9b8a6857

The branch, master has been updated
       via  bd9c233305b0abc867eea1deddde55be9b8a6857 (commit)
      from  de8a83c3e977937782ef3ce686909d7fa7538e81 (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 bd9c233305b0abc867eea1deddde55be9b8a6857
Author: Bruno Haible <address@hidden>
Date:   Sat Jul 25 09:38:39 2009 -0600

    Clarify autom4te debugging tips.
    
    * doc/autoconf.texi (Debugging via autom4te): Fix example from
    previous commit, and add clarification.
    
    Signed-off-by: Eric Blake <address@hidden>

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

Summary of changes:
 ChangeLog         |    6 ++++++
 doc/autoconf.texi |   48 +++++++++++++++++-------------------------------
 2 files changed, 23 insertions(+), 31 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 4ed5149..4ecd0d8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2009-07-25  Bruno Haible  <address@hidden>
+
+       Clarify autom4te debugging tips.
+       * doc/autoconf.texi (Debugging via autom4te): Fix example from
+       previous commit, and add clarification.
+
 2009-07-25  Eric Blake  <address@hidden>
 
        Document some autom4te debugging tips.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 0b61e35..39286fd 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -12454,39 +12454,25 @@ $ @kbd{autoconf --trace='AC_INIT:version is $2'}
 version is 2.63b.95-3963
 @end example
 
-Another trick is using @code{m4_errprintn} to output debugging messages
-to standard error with no further m4 expansion, and without interfering
-with the post-processing done to standard output.  For example, contrast
-these two attempts to learn how @code{m4_dquote} is implemented:
+Another trick is to print out the expansion of various m4 expressions to
+standard error or to an independent file, with no further m4 expansion,
+and without interfering with diversion changes or the post-processing
+done to standard output.  @code{m4_errprintn} shows a given expression
+on standard error.  For example, if you want to see the expansion of an
+autoconf primitive or of one of your autoconf macros, you can do it like
+this:
 
address@hidden
-$ @kbd{cat <<\EOF > foo.m4}
-m4_init
-try one: [m4_dquote is ]m4_defn([m4_dquote])
-m4_divert([0])dnl
-try two: [m4_dquote is ]m4_defn([m4_dquote])
-m4_dquote([hi])
-EOF
-$ @kbd{autom4te --language=m4sugar -o foo foo.m4}
-foo.m4:2: error: possibly undefined macro: m4_dquote
-      If this token and others are legitimate, please use m4_pattern_allow.
-      See the Autoconf documentation.
-$ @kbd{cat foo}
-try two: m4_dquote is [$@@]
-[hi]
-$ @kbd{cat <<\EOF > foo.m4}
-m4_init
-m4_errprintn([try one: m4_dquote is ]m4_defn([m4_dquote]))
-m4_divert([0])dnl
-m4_errprintn([try two: m4_dquote is ]m4_defn([m4_dquote]))dnl
-m4_dquote([hi])
address@hidden
+$ @kbd{cat <<\EOF > configure.ac}
+AC_INIT
+m4_errprintn([The definition of AC_DEFINE_UNQUOTED:])
+m4_errprintn(m4_defn([AC_DEFINE_UNQUOTED]))
+AC_OUTPUT
 EOF
-$ @kbd{autom4te --language=m4sugar foo.m4}
-try one: m4_dquote is [$@@]
-try two: m4_dquote is [$@@]
-$ @kbd{cat foo}
-[hi]
address@hidden smallexample
+$ @kbd{autoconf}
address@hidden definition of AC_DEFINE_UNQUOTED:
address@hidden([], $@@)
address@hidden example
 
 @node Programming in M4sh
 @chapter Programming in M4sh


hooks/post-receive
-- 
GNU Autoconf source repository