[SCM] GNU Autoconf source repository branch, master, updated. v2.64-26-g36a50d9

[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=36a50d910d2b917453617130298166f47c0ddc78

The branch, master has been updated
       via  36a50d910d2b917453617130298166f47c0ddc78 (commit)
       via  129ac3155a855a69e4bfc2c25b045b230535fe1a (commit)
       via  714bcc196fe307a5a60e6f616585783628ea9706 (commit)
      from  1fbc0eb1148e871c20c68d6349cbf11c6e4bc175 (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 36a50d910d2b917453617130298166f47c0ddc78
Author: Reuben Thomas <address@hidden>
Date:   Fri Sep 4 07:01:49 2009 -0600

    Mention the Autoconf archive.
    
    * doc/autoconf.texi (Coding Style): Add a link.
    
    Signed-off-by: Eric Blake <address@hidden>

commit 129ac3155a855a69e4bfc2c25b045b230535fe1a
Author: Bruno Haible <address@hidden>
Date:   Fri Sep 4 06:32:04 2009 -0600

    Document another Solaris tr pitfall.
    
    * doc/autoconf.texi (Limitations of Usual Tools) <tr>: Mention
    that Solaris /usr/bin/tr does not only have problems with
    replacing NUL bytes but discards all NUL bytes from the input.
    
    Signed-off-by: Eric Blake <address@hidden>

commit 714bcc196fe307a5a60e6f616585783628ea9706
Author: Eric Blake <address@hidden>
Date:   Fri Sep 4 06:18:52 2009 -0600

    Improve wording about what goes before AC_INIT.
    
    * doc/autoconf.texi (Initializing configure): Update wording.
    (Versioning) <AC_PREREQ>: Remove misleading text, to match
    autoupdate's behavior.
    * THANKS: Update.
    Reported by NightStrike, with input from Ralf Wildenhues.
    
    Signed-off-by: Eric Blake <address@hidden>

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

Summary of changes:
 ChangeLog         |   21 +++++++++++++++++++++
 THANKS            |    1 +
 doc/autoconf.texi |   27 ++++++++++++++++++---------
 3 files changed, 40 insertions(+), 9 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 1ff51b4..d074681 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,24 @@
+2009-09-04  Reuben Thomas <address@hidden>  (tiny change)
+
+       Mention the Autoconf archive.
+       * doc/autoconf.texi (Coding Style): Add a link.
+
+2009-08-30  Bruno Haible  <address@hidden>
+
+       Document another Solaris tr pitfall.
+       * doc/autoconf.texi (Limitations of Usual Tools) <tr>: Mention
+       that Solaris /usr/bin/tr does not only have problems with
+       replacing NUL bytes but discards all NUL bytes from the input.
+
+2009-09-04  Eric Blake  <address@hidden>
+
+       Improve wording about what goes before AC_INIT.
+       * doc/autoconf.texi (Initializing configure): Update wording.
+       (Versioning) <AC_PREREQ>: Remove misleading text, to match
+       autoupdate's behavior.
+       * THANKS: Update.
+       Reported by NightStrike, with input from Ralf Wildenhues.
+
 2009-09-04  Thomas Jahns  <address@hidden>  (tiny change)
 
        Fix illegal tab character in Fortran source.
diff --git a/THANKS b/THANKS
index c9237e0..460e680 100644
--- a/THANKS
+++ b/THANKS
@@ -264,6 +264,7 @@ Nathanael Nerode            address@hidden
 Nelson H. F. Beebe          address@hidden
 Nicolas Joly                address@hidden
 Nicolás Lichtmaier          address@hidden
+NightStrike                 address@hidden
 Nishio Futoshi              address@hidden
 Noah Elliott                address@hidden
 Noah Friedman               address@hidden
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index e997962..6f06577 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -1754,8 +1754,11 @@ initialization and the creation of output files.
 @section Initializing @command{configure}
 
 Every @command{configure} script must call @code{AC_INIT} before doing
-anything else.  The only other required macro is @code{AC_OUTPUT}
-(@pxref{Output}).
+anything else that produces output.  Calls to silent macros, such as
address@hidden, may also occur prior to @code{AC_INIT}, although these
+are generally used via @file{aclocal.m4}, since that is implicitly
+included before the start of @file{configure.ac}.  The only other
+required macro is @code{AC_OUTPUT} (@pxref{Output}).
 
 @anchor{AC_INIT}
 @defmac AC_INIT (@var{package}, @var{version}, @ovar{bug-report}, @
@@ -1854,8 +1857,7 @@ error output and exit with failure (exit status is 63).  
For example:
 AC_PREREQ(address@hidden)
 @end example
 
-This macro is the only macro that may be used before @code{AC_INIT}, but
-for consistency, you are invited not to do so.
+This macro may be used before @code{AC_INIT}.
 @end defmac
 
 @defmac AC_AUTOCONF_VERSION
@@ -13660,7 +13662,9 @@ with the same parameters.  This happens for example if 
the macro was renamed.
 
 The Autoconf macros follow a strict coding style.  You are encouraged to
 follow this style, especially if you intend to distribute your macro,
-either by contributing it to Autoconf itself, or via other means.
+either by contributing it to Autoconf itself or the
address@hidden://@/www.nongnu.org/@/autoconf-archive, Autoconf
+archive}, or by other means.
 
 The first requirement is to pay great attention to the quotation.  For
 more details, see @ref{Autoconf Language}, and @ref{M4 Quotation}.
@@ -17815,16 +17819,21 @@ HAZY FANTAZY
 
 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}.  On Solaris, when
-using @command{tr} to neutralize a binary file by converting @code{NUL}
-to a different character, it is necessary to use
address@hidden/usr/xpg4/bin/tr} instead.
+handle @samp{\0} as the octal escape for @code{NUL}; these programs
+always discard all @code{NUL} bytes from the input.  On Solaris, 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
address@hidden/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
 @end example
 
 @end table


hooks/post-receive
-- 
GNU Autoconf source repository