[SCM] GNU Autoconf source repository branch, master, updated. v2.65-17-g8c323c0

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=8c323c07b5c240daae1e636a01bd66892d5e89eb

The branch, master has been updated
       via  8c323c07b5c240daae1e636a01bd66892d5e89eb (commit)
       via  b562e95c9e1b27fb22a7aa6526747f170c038678 (commit)
      from  81074eaa201a289d11b6be05e0c78afbe5ff79f5 (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 8c323c07b5c240daae1e636a01bd66892d5e89eb
Author: Eric Blake <[email protected]>
Date:   Tue Dec 29 14:57:35 2009 -0700

    Improve documentation on tr portability.
    
    * doc/autoconf.texi (Limitations of Usual Tools) <tr>: Refine
    description of NUL handling.  Document set size issue.
    Reported by Bruno Haible.
    
    Signed-off-by: Eric Blake <[email protected]>

commit b562e95c9e1b27fb22a7aa6526747f170c038678
Author: Eric Blake <[email protected]>
Date:   Mon Dec 21 16:47:57 2009 -0700

    Fix comment in AC_CHECK_DECLS.
    
    * lib/autoconf/general.m4 (AC_CHECK_DECL): Document the includes
    argument to the shell function.
    
    Signed-off-by: Eric Blake <[email protected]>

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

Summary of changes:
 ChangeLog               |   11 +++++++++++
 doc/autoconf.texi       |   30 +++++++++++++++++++-----------
 lib/autoconf/general.m4 |    5 +++--
 3 files changed, 33 insertions(+), 13 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 64a499e..9f83625 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2009-12-29  Eric Blake  <[email protected]>
+
+	Improve documentation on tr portability.
+	* doc/autoconf.texi (Limitations of Usual Tools) <tr>: Refine
+	description of NUL handling.  Document set size issue.
+	Reported by Bruno Haible.
+
+	Fix comment in AC_CHECK_DECLS.
+	* lib/autoconf/general.m4 (AC_CHECK_DECL): Document the includes
+	argument to the shell function.
+
 2009-12-15  Ralf Wildenhues  <[email protected]>
 
 	Add testsuite exposure for shtool usage.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 76bb279..335bb33 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -18336,23 +18336,31 @@ $ @kbd{echo "Hazy Fantazy" | LC_ALL=C /usr/xpg4/bin/tr a-z A-Z}
 HAZY FANTAZY
 @end example
 
+When providing two arguments, be sure the second string is at least as
+long as the first.
+
+@example
+$ @kbd{echo abc | /usr/xpg4/bin/tr bc d}
+adc
+$ @kbd{echo abc | tr bc d}
+add
+@end example
+
 Posix requires @command{tr} to operate on binary files.  But at least
-Solaris @command{/usr/ucb/tr} and @command{/usr/bin/tr} still fail to
-handle @samp{\0} as the octal escape for @code{NUL}; these programs
-always discard all @code{NUL} bytes from the input.  On Solaris, when
+Solaris @command{/usr/ucb/tr} fails to handle @samp{\0} as the octal
+escape for @code{NUL}, and Solaris @command{/usr/bin/tr} silently
+discards @code{NUL} in the input prior to doing any translation.  When
 using @command{tr} to process a binary file that may contain @code{NUL}
 bytes, it is necessary to use @command{/usr/xpg4/bin/tr} instead, or
 @command{/usr/xpg6/bin/tr} if that is available.
 
 @example
-$ @kbd{printf 'a\0b\n' | /usr/ucb/tr '\0' '~' | wc -c}
-3
-$ @kbd{printf 'a\0b\n' | /usr/xpg4/bin/tr '\0' '~' | wc -c}
-4
-$ @kbd{printf 'a\0b\n' | /usr/ucb/tr x x | wc -c}
-3
-$ @kbd{printf 'a\0b\n' | /usr/xpg4/bin/tr x x | wc -c}
-4
+$ @kbd{printf 'ab\0c' | /usr/ucb/tr 'a\0' '\0d' | od -An -tx1}
+ 61 62 63
+$ @kbd{printf 'ab\0c' | /usr/bin/tr 'a\0' '\0d' | od -An -tx1}
+ 00 62 63
+$ @kbd{printf 'ab\0c' | /usr/xpg4/bin/tr 'a\0' '\0d' | od -An -tx1}
+ 00 62 64 63
 @end example
 
 @end table
diff --git a/lib/autoconf/general.m4 b/lib/autoconf/general.m4
index e41c2c9..6580e7f 100644
--- a/lib/autoconf/general.m4
+++ b/lib/autoconf/general.m4
@@ -2811,8 +2811,9 @@ m4_define([_AC_CHECK_DECL_BODY],
 AC_DEFUN([AC_CHECK_DECL],
 [AC_REQUIRE_SHELL_FN([ac_fn_]_AC_LANG_ABBREV[_check_decl],
   [AS_FUNCTION_DESCRIBE([ac_fn_]_AC_LANG_ABBREV[_check_decl],
-    [LINENO SYMBOL VAR],
-    [Tests whether SYMBOL is declared, setting cache variable VAR accordingly.])],
+    [LINENO SYMBOL VAR INCLUDES],
+    [Tests whether SYMBOL is declared in INCLUDES, setting cache variable
+     VAR accordingly.])],
   [_$0_BODY])]dnl
 [AS_VAR_PUSHDEF([ac_Symbol], [ac_cv_have_decl_$1])]dnl
 [ac_fn_[]_AC_LANG_ABBREV[]_check_decl ]dnl


hooks/post-receive
-- 
GNU Autoconf source repository