[SCM] GNU Autoconf source repository branch, master, updated. v2.61a-349-ga0d6f35

[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=a0d6f350fee9d91382295e89d7cc50dc2a2cfadc

The branch, master has been updated
       via  a0d6f350fee9d91382295e89d7cc50dc2a2cfadc (commit)
      from  c6c22af0e79a7f08c150f6dc59841be914dfa66d (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 a0d6f350fee9d91382295e89d7cc50dc2a2cfadc
Author: Eric Blake <address@hidden>
Date:   Wed Jan 23 20:24:47 2008 -0700

    * doc/autoconf.texi (Limitations of Usual Tools) <grep>: Document
    BSD behavior on binary input.
    
    Signed-off-by: Eric Blake <address@hidden>

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

Summary of changes:
 ChangeLog         |    4 ++++
 doc/autoconf.texi |   14 ++++++++++++++
 2 files changed, 18 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b8e7fb0..a3f52fe 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2008-01-28  Eric Blake  <address@hidden>
 
+       Document grep peculiarity.
+       * doc/autoconf.texi (Limitations of Usual Tools) <grep>: Document
+       BSD behavior on binary input.
+
        Minor testsuite improvements.
        * lib/autotest/general.m4 (AT_INIT) <PREPARE_TESTS>: Use fewer
        forks when sanitizing PATH.  Always output machine information,
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 59e6f97..f6421d7 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -14957,6 +14957,20 @@ Similarly, the following escape sequences should also 
be avoided:
 @samp{\<}, @samp{\>}, @samp{\+}, @samp{\?}, @samp{\`}, @samp{\'},
 @samp{\B}, @samp{\b}, @samp{\S}, @samp{\s}, @samp{\W}, and @samp{\w}.
 
+Posix does not specify the behavior of @command{grep} on binary files.
+An example where this matters is using @acronym{BSD} @command{grep} to
+search text that includes embedded @acronym{ANSI} escape sequences for
+colored output to terminals (@samp{\033[m} is the sequence to restore
+normal output); the behavior depends on whether input is seekable:
+
address@hidden
+$ @kbd{printf 'esc\033[mape\n' > sample}
+$ @kbd{grep . sample}
+Binary file sample matches
+$ @kbd{cat file | grep .}
+escape
address@hidden example
+
 
 @item @command{join}
 @c -----------------


hooks/post-receive
--
GNU Autoconf source repository