From: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
Date: Thu, 25 May 2006 08:49:02 +0000 (+0000)
Subject: * doc/autoconf.texi (Here-Documents): We now know more about
X-Git-Tag: AUTOCONF-2.59d~44
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=beaa9ebbcb191fc0abc9f585a50be2fc3ee8c4a0;p=thirdparty%2Fautoconf.git

* doc/autoconf.texi (Here-Documents): We now know more about
the variable expansion in here documents bug.
Thanks to Tim Rice and Stepan Kasal.
---

diff --git a/ChangeLog b/ChangeLog
index d0a5b66a0..759612a3e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2006-05-25  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>
 
+	* doc/autoconf.texi (Here-Documents): We now know more about
+	the variable expansion in here documents bug.
+	Thanks to Tim Rice and Stepan Kasal.
+
 	* doc/autoconf.texi (Making testsuite Scripts): Add an example
 	how to use TESTSUITEFLAGS.  Suggested by Eric Blake.
 
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 34d19df15..af79b3a4c 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -10748,13 +10748,14 @@ bash-2.04$ @kbd{cat <<EOF
 
 
 Many older shells (including the Bourne shell) implement here-documents
-inefficiently.  And some shells mishandle large here-documents: for
-example, Solaris @command{dtksh}, which is derived from Korn shell
-version M-12/28/93d, mishandles variable expansion that occurs on
-1024-byte buffer boundaries within a here-document.  Users can generally
-fix these problems by using a faster or more reliable shell, e.g., by
-using the command @samp{CONFIG_SHELL=/bin/bash /bin/bash ./configure} rather
-than plain @samp{./configure}.
+inefficiently.  And some shells mishandle large here-documents: for example,
+Solaris 10 @command{dtksh} and the UnixWare 7.1.1 Posix shell, which are
+derived from Korn shell version M-12/28/93d, mishandle braced variable
+expansion @code{$@{var@}} that crosses a 1024- or 4096-byte buffer boundary
+within a here-document.  If the closing brace does not lie on the boundary,
+the failure is silent and the variable expansion will be empty, otherwise
+the shell will report a bad substitution.  This bug can usually be worked
+around by omitting the braces: @code{$var}.
 
 Some shells can be extremely inefficient when there are a lot of
 here-documents inside a single statement.  For instance if your