[SCM] GNU Autoconf source repository branch, master, updated. v2.68b-16-g943789e

[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=943789e03f5d3041e223e439dde8851484e2d99a

The branch, master has been updated
       via  943789e03f5d3041e223e439dde8851484e2d99a (commit)
      from  da4121067329547fcbb9b1765c65f884599b2631 (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 943789e03f5d3041e223e439dde8851484e2d99a
Author: Eric Blake <address@hidden>
Date:   Wed Mar 7 11:11:58 2012 -0700

    docs: document set -n pitfalls
    
    * doc/autoconf.texi (Limitations of Builtins) <set>: Document
    issues with set -n.

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

Summary of changes:
 doc/autoconf.texi |   20 ++++++++++++++++++++
 1 files changed, 20 insertions(+), 0 deletions(-)

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 9442e22..2ae8bb9 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -18083,6 +18083,26 @@ cim
 c
 @end example
 
address@hidden @command{set -n}
+Use of @command{set -n} (typically via @command{sh -n script}) to
+validate a script is not foolproof.  Modern @command{ksh93} tries to be
+helpful by informing you about better syntax, but switching the script
+to use the suggested syntax in order to silence the warnings would
+render the script no longer portable to older shells:
+
address@hidden
+$ @kbd{ksh -nc '``'}
+ksh: warning: line 1: `...` obsolete, use $(...)
+0
address@hidden example
+
+Furthermore, on ancient hosts, such as SunOS 4, @command{sh -n} could go
+into an infinite loop; even with that bug fixed, Solaris 8
address@hidden/bin/sh} takes extremely long to parse large scripts.  Autoconf
+itself uses @command{sh -n} within its testsuite to check that correct
+scripts were generated, but only after first probing for other shell
+features (such as @code{test -n "address@hidden@}"}) that indicate
+a reasonably fast and working implementation.
 
 @item @command{shift}
 @c ------------------


hooks/post-receive
-- 
GNU Autoconf source repository