From: Stefano Lattarini <stefano.lattarini@gmail.com>
Date: Sat, 24 Dec 2011 15:43:36 +0000 (+0100)
Subject: docs: issue with shell functions and here-documents on Solaris
X-Git-Tag: v2.68b~41
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d1b31ac57cc069527d037f3291e643813ce0bd69;p=thirdparty%2Fautoconf.git

docs: issue with shell functions and here-documents on Solaris

* doc/autoconf.texi (Here-Documents): Using a command substitution
in a here-documents being fed to a shell function is unportable.

Problem revealed by the automake testsuite:
<http://lists.gnu.org/archive/html/automake-patches/2011-12/msg00149.html>
---

diff --git a/ChangeLog b/ChangeLog
index 25799b28..8eaf0d7f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2011-12-24  Stefano Lattarini  <stefano.lattarini@gmail.com>
+
+	docs: issue with shell functions and here-documents on Solaris
+	* doc/autoconf.texi (Here-Documents): Using a command substitution
+	in a here-documents being fed to a shell function is unportable.
+	Problem revealed by the automake testsuite:
+	<http://lists.gnu.org/archive/html/automake-patches/2011-12/msg00149.html>
+
 2011-12-26  Paul Eggert  <eggert@cs.ucla.edu>
 
 	AS_LN_S: fall back on 'cp -pR' (not 'cp -p') if 'ln -s' fails
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 0354dfb5..4c897503 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -15239,6 +15239,19 @@ bash-2.04$ @kbd{cat <<EOF
 @end group
 @end example
 
+Using command substitutions in a here-document that is fed to a shell
+function is not portable.  For example, with Solaris 10 @command{/bin/sh}:
+
+@example
+$ @kbd{kitty () @{ cat; @}}
+$ @kbd{kitty <<EOF
+> `echo ok`
+> EOF}
+/tmp/sh199886: cannot open
+$ @kbd{echo $?}
+1
+@end example
+
 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