From MAILER-DAEMON Fri Jul 11 16:22:09 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1X5hKb-0005hV-5D
	for mharc-grep-commit@gnu.org; Fri, 11 Jul 2014 16:22:09 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:41454)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eggert@cs.ucla.edu>) id 1X5hKY-0005hN-Re
	for grep-commit@gnu.org; Fri, 11 Jul 2014 16:22:08 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <eggert@cs.ucla.edu>) id 1X5hKX-0003s4-Hz
	for grep-commit@gnu.org; Fri, 11 Jul 2014 16:22:06 -0400
Received: from vcs.savannah.gnu.org ([140.186.70.72]:41552)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eggert@cs.ucla.edu>) id 1X5hKX-0003rx-Ej
	for grep-commit@gnu.org; Fri, 11 Jul 2014 16:22:05 -0400
Received: from eggert by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <eggert@cs.ucla.edu>) id 1X5hKW-0000u0-6D
	for grep-commit@gnu.org; Fri, 11 Jul 2014 20:22:04 +0000
Date: Fri, 11 Jul 2014 20:22:04 +0000
Message-Id: <E1X5hKW-0000u0-6D@vcs.savannah.gnu.org>
To: grep-commit@gnu.org
Subject: grep branch, master, updated. v2.20-15-g846fe08
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: 09434c399629d16bc4fceb443aa3e5cea412f4ea
X-Git-Newrev: 846fe088f835d481fc1b237f5c24e336a317d112
From: Paul Eggert <eggert@cs.ucla.edu>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
X-BeenThere: grep-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: bug-grep@gnu.org
List-Id: CVS commit notices for GNU grep <grep-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/grep-commit>,
	<mailto:grep-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/grep-commit>
List-Post: <mailto:grep-commit@gnu.org>
List-Help: <mailto:grep-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/grep-commit>,
	<mailto:grep-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 11 Jul 2014 20:22:08 -0000

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 "grep".

The branch, master has been updated
       via  846fe088f835d481fc1b237f5c24e336a317d112 (commit)
      from  09434c399629d16bc4fceb443aa3e5cea412f4ea (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 -----------------------------------------------------------------
http://git.savannah.gnu.org/cgit/grep.git/commit/?id=846fe088f835d481fc1b237f5c24e336a317d112


commit 846fe088f835d481fc1b237f5c24e336a317d112
Author: Paul Eggert <eggert@cs.ucla.edu>
Date:   Fri Jul 11 13:21:19 2014 -0700

    doc: Document -r vs --exclude more carefully.
    
    Problem reported by Hugues Andreux in: http://bugs.gnu.org/17763
    * doc/grep.texi (File and Directory Selection): Be more careful
    about documenting the interaction between recursive searching,
    --include, --exclude, and --exclude-dir.

diff --git a/doc/grep.texi b/doc/grep.texi
index 6c484d6..0115560 100644
--- a/doc/grep.texi
+++ b/doc/grep.texi
@@ -651,9 +651,10 @@ this is equivalent to the @option{-r} option.
 @opindex --exclude
 @cindex exclude files
 @cindex searching directory trees
-Skip files whose base name matches @var{glob}
-(using wildcard matching).
-A file-name glob can use
+Skip files whose name matches the pattern @var{glob}, using wildcard
+matching.  When searching recursively, skip any subfile whose base
+name matches @var{glob}; the base name is the part after the last
+@samp{/}.  A pattern can use
 @samp{*}, @samp{?}, and @samp{[}...@samp{]} as wildcards,
 and @code{\} to quote a wildcard or backslash character literally.
 
@@ -661,15 +662,16 @@ and @code{\} to quote a wildcard or backslash character literally.
 @opindex --exclude-from
 @cindex exclude files
 @cindex searching directory trees
-Skip files whose base name matches any of the file-name globs
+Skip files whose name matches any of the patterns
 read from @var{file} (using wildcard matching as described
 under @option{--exclude}).
 
-@item --exclude-dir=@var{dir}
+@item --exclude-dir=@var{glob}
 @opindex --exclude-dir
 @cindex exclude directories
-Skip any directory whose name matches the pattern @var{dir}, ignoring
-any redundant trailing slashes in @var{dir}.
+Skip any directory whose name matches the pattern @var{glob}.  When
+searching recursively, skip any subdirectory whose base name matches
+@var{glob}.  Ignore any redundant trailing slashes in @var{glob}.
 
 @item -I
 Process a binary file as if it did not contain matching data;
@@ -679,8 +681,8 @@ this is equivalent to the @samp{--binary-files=without-match} option.
 @opindex --include
 @cindex include files
 @cindex searching directory trees
-Search only files whose base name matches @var{glob}
-(using wildcard matching as described under @option{--exclude}).
+Search only files whose name matches @var{glob},
+using wildcard matching as described under @option{--exclude}.
 
 @item -r
 @itemx --recursive

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

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


hooks/post-receive
-- 
grep


