[SCM] GNU Autoconf source repository branch, master, updated. v2.65-30-gf4fc1ad

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

The branch, master has been updated
       via  f4fc1ad9bbd765a84dd6033e03541ffde9c7c045 (commit)
      from  a21c6c2ea6186d099ae29fe19d1a511849d5d50e (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 f4fc1ad9bbd765a84dd6033e03541ffde9c7c045
Author: Eric Blake <address@hidden>
Date:   Wed Jan 13 06:03:07 2010 -0700

    Document here-doc pitfall.
    
    * doc/autoconf.texi (Here-Documents): Mention problem with <<-
    operator.
    Reported by Jim Meyering.
    
    Signed-off-by: Eric Blake <address@hidden>

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

Summary of changes:
 ChangeLog         |    7 +++++++
 doc/autoconf.texi |   16 ++++++++++++++++
 2 files changed, 23 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 6b6fd80..3fa0c5d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2010-01-13  Eric Blake  <address@hidden>
+
+       Document here-doc pitfall.
+       * doc/autoconf.texi (Here-Documents): Mention problem with <<-
+       operator.
+       Reported by Jim Meyering.
+
 2010-01-12  Eric Blake  <address@hidden>
 
        Typo fix in earlier commit.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index ce6ac88..31550fd 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -14691,6 +14691,22 @@ macro when it was expanded before in a conditional 
path, and the
 condition turned out to be false at runtime, and we end up not
 executing the macro at all.
 
+Be careful with the use of @samp{<<-} to unindent here-documents.  The
+behavior is only portable for stripping leading @key{TAB}s, and things
+can silently break if an overzealous editor converts to using leading
+spaces (not all shells are nice enough to warn about unterminated
+here-documents).
+
address@hidden
+$ @kbd{printf 'cat <<-x\n\t1\n\t 2\n\tx\n' | bash && echo oops}
+1
+ 2
+$ @kbd{printf 'cat <<-x\n 1\n  2\n x\n' | bash-3.2 && echo oops}
+ 1
+  2
+ x
address@hidden example
+
 @node File Descriptors
 @section File Descriptors
 @cindex Descriptors


hooks/post-receive
-- 
GNU Autoconf source repository