Fix shell code in AS_TR_SH documentation.

* doc/autoconf.texi (Common Shell Constructs) <AS_TR_SH>: Fix
example to expand to valid shell code.
Reported by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>

diff --git a/ChangeLog b/ChangeLog
index 747a6290dc6be680b565eb0e7cba61e2dc46a36d..5aae86c8a0aa3a9213e21849507125f507e159fb 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2010-03-02  Eric Blake  <eblake@redhat.com>
 
+       Fix shell code in AS_TR_SH documentation.
+       * doc/autoconf.texi (Common Shell Constructs) <AS_TR_SH>: Fix
+       example to expand to valid shell code.
+       Reported by Ralf Wildenhues.
+
        Improve documentation on AC_{COMPILE,LINK}_IFELSE.
        * doc/autoconf.texi (Running the Compiler): Mention that the
        object file is available after a successful compile.

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 7838f76cf9e2d6093fab7d2ac0279b4edf87e2d3..8fca9ae2b0ad76e00f7006dbd7033c23eb9d437a 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -13206,12 +13206,15 @@ echo "[#]define AS_TR_CPP([HAVE_$type]) 1"
 
 @defmac AS_TR_SH (@var{expression})
 @asindex{TR_SH}
-Transform @var{expression} into a valid shell variable name.  For example:
+Transform @var{expression} into shell code that generates a valid shell
+variable name.  The result is literal when possible at m4 time, but must
+be used with @code{eval} if @var{expression} causes shell indirections.
+For example:
 
 @example
 # This outputs "Have it!".
 header="sys/some file.h"
-AS_TR_SH([HAVE_$header])=yes
+eval AS_TR_SH([HAVE_$header])=yes
 if test "x$HAVE_sys_some_file_h" = xyes; then echo "Have it!"; fi
 @end example
 @end defmac