grep-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Changes to grep/manual/html_node/File-and-Directory-Selection.html,v


From: Jim Meyering
Subject: Changes to grep/manual/html_node/File-and-Directory-Selection.html,v
Date: Tue, 24 Apr 2012 08:04:09 +0000

CVSROOT:        /webcvs/grep
Module name:    grep
Changes by:     Jim Meyering <meyering> 12/04/24 08:04:00

Index: html_node/File-and-Directory-Selection.html
===================================================================
RCS file: /webcvs/grep/grep/manual/html_node/File-and-Directory-Selection.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- html_node/File-and-Directory-Selection.html 2 Mar 2012 09:28:29 -0000       
1.10
+++ html_node/File-and-Directory-Selection.html 24 Apr 2012 08:03:55 -0000      
1.11
@@ -1,8 +1,8 @@
 <html lang="en">
 <head>
-<title>File and Directory Selection - GNU Grep 2.11</title>
+<title>File and Directory Selection - GNU Grep 2.12</title>
 <meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="GNU Grep 2.11">
+<meta name="description" content="GNU Grep 2.12">
 <meta name="generator" content="makeinfo 4.13">
 <link title="Top" rel="start" href="index.html#Top">
 <link rel="up" href="Command_002dline-Options.html#Command_002dline-Options" 
title="Command-line Options">
@@ -72,12 +72,17 @@
 if the terminal driver interprets some of it as commands.
 
      <br><dt><samp><span class="option">-D 
</span><var>action</var></samp><dt><samp><span 
class="option">--devices=</span><var>action</var></samp><dd><a 
name="index-g_t_002dD-98"></a><a name="index-g_t_002d_002ddevices-99"></a><a 
name="index-device-search-100"></a>If an input file is a device, FIFO, or 
socket, use <var>action</var> to process it. 
-By default, <var>action</var> is &lsquo;<samp><span 
class="samp">read</span></samp>&rsquo;,
-which means that devices are read just as if they were ordinary files. 
+If <var>action</var> is &lsquo;<samp><span 
class="samp">read</span></samp>&rsquo;,
+all devices are read just as if they were ordinary files. 
 If <var>action</var> is &lsquo;<samp><span 
class="samp">skip</span></samp>&rsquo;,
 devices, FIFOs, and sockets are silently skipped.
+By default, devices are read if they are on the command line or if the
+<samp><span class="option">-R</span></samp> (<samp><span 
class="option">--dereference-recursive</span></samp>) option is used, and are
+skipped if they are encountered recursively and the <samp><span 
class="option">-r</span></samp>
+(<samp><span class="option">--recursive</span></samp>) option is used. 
+This option has no effect on a file that is read via standard input.
 
-     <br><dt><samp><span class="option">-d 
</span><var>action</var></samp><dt><samp><span 
class="option">--directories=</span><var>action</var></samp><dd><a 
name="index-g_t_002dd-101"></a><a 
name="index-g_t_002d_002ddirectories-102"></a><a 
name="index-directory-search-103"></a>If an input file is a directory, use 
<var>action</var> to process it. 
+     <br><dt><samp><span class="option">-d 
</span><var>action</var></samp><dt><samp><span 
class="option">--directories=</span><var>action</var></samp><dd><a 
name="index-g_t_002dd-101"></a><a 
name="index-g_t_002d_002ddirectories-102"></a><a 
name="index-directory-search-103"></a><a name="index-symbolic-links-104"></a>If 
an input file is a directory, use <var>action</var> to process it. 
 By default, <var>action</var> is &lsquo;<samp><span 
class="samp">read</span></samp>&rsquo;,
 which means that directories are read just as if they were ordinary files
 (some operating systems and file systems disallow this,
@@ -85,32 +90,38 @@
 to print error messages for every directory or silently skip them). 
 If <var>action</var> is &lsquo;<samp><span 
class="samp">skip</span></samp>&rsquo;, directories are silently skipped. 
 If <var>action</var> is &lsquo;<samp><span 
class="samp">recurse</span></samp>&rsquo;,
-<samp><span class="command">grep</span></samp> reads all files under each 
directory, recursively;
+<samp><span class="command">grep</span></samp> reads all files under each 
directory, recursively,
+following command-line symbolic links and skipping other symlinks;
 this is equivalent to the <samp><span class="option">-r</span></samp> option.
 
-     <br><dt><samp><span 
class="option">--exclude=</span><var>glob</var></samp><dd><a 
name="index-g_t_002d_002dexclude-104"></a><a 
name="index-exclude-files-105"></a><a 
name="index-searching-directory-trees-106"></a>Skip files whose base name 
matches <var>glob</var>
+     <br><dt><samp><span 
class="option">--exclude=</span><var>glob</var></samp><dd><a 
name="index-g_t_002d_002dexclude-105"></a><a 
name="index-exclude-files-106"></a><a 
name="index-searching-directory-trees-107"></a>Skip files whose base name 
matches <var>glob</var>
 (using wildcard matching). 
 A file-name glob can use
 &lsquo;<samp><span class="samp">*</span></samp>&rsquo;, &lsquo;<samp><span 
class="samp">?</span></samp>&rsquo;, and &lsquo;<samp><span 
class="samp">[</span></samp>&rsquo;...&lsquo;<samp><span 
class="samp">]</span></samp>&rsquo; as wildcards,
 and <code>\</code> to quote a wildcard or backslash character literally.
 
-     <br><dt><samp><span 
class="option">--exclude-from=</span><var>file</var></samp><dd><a 
name="index-g_t_002d_002dexclude_002dfrom-107"></a><a 
name="index-exclude-files-108"></a><a 
name="index-searching-directory-trees-109"></a>Skip files whose base name 
matches any of the file-name globs
+     <br><dt><samp><span 
class="option">--exclude-from=</span><var>file</var></samp><dd><a 
name="index-g_t_002d_002dexclude_002dfrom-108"></a><a 
name="index-exclude-files-109"></a><a 
name="index-searching-directory-trees-110"></a>Skip files whose base name 
matches any of the file-name globs
 read from <var>file</var> (using wildcard matching as described
 under <samp><span class="option">--exclude</span></samp>).
 
-     <br><dt><samp><span 
class="option">--exclude-dir=</span><var>dir</var></samp><dd><a 
name="index-g_t_002d_002dexclude_002ddir-110"></a><a 
name="index-exclude-directories-111"></a>Exclude directories matching the 
pattern <var>dir</var> from recursive
+     <br><dt><samp><span 
class="option">--exclude-dir=</span><var>dir</var></samp><dd><a 
name="index-g_t_002d_002dexclude_002ddir-111"></a><a 
name="index-exclude-directories-112"></a>Exclude directories matching the 
pattern <var>dir</var> from recursive
 directory searches.
 
      <br><dt><samp><span class="option">-I</span></samp><dd>Process a binary 
file as if it did not contain matching data;
 this is equivalent to the &lsquo;<samp><span 
class="samp">--binary-files=without-match</span></samp>&rsquo; option.
 
-     <br><dt><samp><span 
class="option">--include=</span><var>glob</var></samp><dd><a 
name="index-g_t_002d_002dinclude-112"></a><a 
name="index-include-files-113"></a><a 
name="index-searching-directory-trees-114"></a>Search only files whose base 
name matches <var>glob</var>
+     <br><dt><samp><span 
class="option">--include=</span><var>glob</var></samp><dd><a 
name="index-g_t_002d_002dinclude-113"></a><a 
name="index-include-files-114"></a><a 
name="index-searching-directory-trees-115"></a>Search only files whose base 
name matches <var>glob</var>
 (using wildcard matching as described under <samp><span 
class="option">--exclude</span></samp>).
 
-     <br><dt><samp><span class="option">-r</span></samp><dt><samp><span 
class="option">-R</span></samp><dt><samp><span 
class="option">--recursive</span></samp><dd><a 
name="index-g_t_002dr-115"></a><a 
name="index-g_t_002d_002drecursive-116"></a><a 
name="index-recursive-search-117"></a><a 
name="index-searching-directory-trees-118"></a>For each directory operand,
+     <br><dt><samp><span class="option">-r</span></samp><dt><samp><span 
class="option">--recursive</span></samp><dd><a 
name="index-g_t_002dr-116"></a><a 
name="index-g_t_002d_002drecursive-117"></a><a 
name="index-recursive-search-118"></a><a 
name="index-searching-directory-trees-119"></a><a 
name="index-symbolic-links-120"></a>For each directory operand,
 read and process all files in that directory, recursively. 
+Follow symbolic links on the command line, but skip symlinks
+that are encountered recursively. 
 This is the same as the &lsquo;<samp><span 
class="samp">--directories=recurse</span></samp>&rsquo; option.
 
+     <br><dt><samp><span class="option">-R</span></samp><dt><samp><span 
class="option">--dereference-recursive</span></samp><dd><a 
name="index-g_t_002dR-121"></a><a 
name="index-g_t_002d_002ddereference_002drecursive-122"></a><a 
name="index-recursive-search-123"></a><a 
name="index-searching-directory-trees-124"></a><a 
name="index-symbolic-links-125"></a>For each directory operand, read and 
process all files in that
+directory, recursively, following all symbolic links.
+
 </dl>
 
    </body></html>



reply via email to

[Prev in Thread] Current Thread [Next in Thread]