/[pcre]/code/trunk/doc/pcregrep.1
ViewVC logotype

Diff of /code/trunk/doc/pcregrep.1

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 392 by ph10, Tue Mar 17 21:30:30 2009 UTC revision 420 by ph10, Wed Aug 12 17:32:27 2009 UTC
# Line 88  standard input is always so treated. Line 88  standard input is always so treated.
88  .  .
89  .SH OPTIONS  .SH OPTIONS
90  .rs  .rs
91    .sp
92    The order in which some of the options appear can affect the output. For
93    example, both the \fB-h\fP and \fB-l\fP options affect the printing of file
94    names. Whichever comes later in the command line will be the one that takes
95    effect.
96  .TP 10  .TP 10
97  \fB--\fP  \fB--\fP
98  This terminate the list of options. It is useful if the next item on the  This terminate the list of options. It is useful if the next item on the
# Line 115  Output \fInumber\fP lines of context bot Line 120  Output \fInumber\fP lines of context bot
120  This is equivalent to setting both \fB-A\fP and \fB-B\fP to the same value.  This is equivalent to setting both \fB-A\fP and \fB-B\fP to the same value.
121  .TP  .TP
122  \fB-c\fP, \fB--count\fP  \fB-c\fP, \fB--count\fP
123  Do not output individual lines; instead just output a count of the number of  Do not output individual lines from the files that are being scanned; instead
124  lines that would otherwise have been output. If several files are given, a  output the number of lines that would otherwise have been shown. If no lines
125  count is output for each of them. In this mode, the \fB-A\fP, \fB-B\fP, and  are selected, the number zero is output. If several files are are being
126  \fB-C\fP options are ignored.  scanned, a count is output for each of them. However, if the
127    \fB--files-with-matches\fP option is also used, only those files whose counts
128    are greater than zero are listed. When \fB-c\fP is used, the \fB-A\fP,
129    \fB-B\fP, and \fB-C\fP options are ignored.
130  .TP  .TP
131  \fB--colour\fP, \fB--color\fP  \fB--colour\fP, \fB--color\fP
132  If this option is given without any data, it is equivalent to "--colour=auto".  If this option is given without any data, it is equivalent to "--colour=auto".
# Line 263  output once, on a separate line. Line 271  output once, on a separate line.
271  \fB-l\fP, \fB--files-with-matches\fP  \fB-l\fP, \fB--files-with-matches\fP
272  Instead of outputting lines from the files, just output the names of the files  Instead of outputting lines from the files, just output the names of the files
273  containing lines that would have been output. Each file name is output  containing lines that would have been output. Each file name is output
274  once, on a separate line. Searching stops as soon as a matching line is found  once, on a separate line. Searching normally stops as soon as a matching line
275  in a file.  is found in a file. However, if the \fB-c\fP (count) option is also used,
276    matching continues in order to obtain the correct count, and those files that
277    have at least one match are listed along with their counts. Using this option
278    with \fB-c\fP is a way of suppressing the listing of files with no matches.
279  .TP  .TP
280  \fB--label\fP=\fIname\fP  \fB--label\fP=\fIname\fP
281  This option supplies a name to be used for the standard input when file names  This option supplies a name to be used for the standard input when file names
# Line 399  The majority of short and long forms of Line 410  The majority of short and long forms of
410  as in the GNU \fBgrep\fP program. Any long option of the form  as in the GNU \fBgrep\fP program. Any long option of the form
411  \fB--xxx-regexp\fP (GNU terminology) is also available as \fB--xxx-regex\fP  \fB--xxx-regexp\fP (GNU terminology) is also available as \fB--xxx-regex\fP
412  (PCRE terminology). However, the \fB--locale\fP, \fB-M\fP, \fB--multiline\fP,  (PCRE terminology). However, the \fB--locale\fP, \fB-M\fP, \fB--multiline\fP,
413  \fB-u\fP, and \fB--utf-8\fP options are specific to \fBpcregrep\fP.  \fB-u\fP, and \fB--utf-8\fP options are specific to \fBpcregrep\fP. If both the
414    \fB-c\fP and \fB-l\fP options are given, GNU grep lists only file names,
415    without counts, but \fBpcregrep\fP gives the counts.
416  .  .
417  .  .
418  .SH "OPTIONS WITH DATA"  .SH "OPTIONS WITH DATA"
# Line 472  Cambridge CB2 3QH, England. Line 485  Cambridge CB2 3QH, England.
485  .rs  .rs
486  .sp  .sp
487  .nf  .nf
488  Last updated: 01 March 2009  Last updated: 12 August 2009
489  Copyright (c) 1997-2009 University of Cambridge.  Copyright (c) 1997-2009 University of Cambridge.
490  .fi  .fi
Legend:
Removed from v.392  
changed lines
  Added in v.420
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12