/[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 279 by ph10, Tue Dec 4 20:01:43 2007 UTC revision 280 by ph10, Wed Dec 5 20:56:03 2007 UTC
# Line 158  is an overall maximum of 100 patterns. T Line 158  is an overall maximum of 100 patterns. T
158  each line, and blank lines are ignored. An empty file contains no patterns and  each line, and blank lines are ignored. An empty file contains no patterns and
159  therefore matches nothing.  therefore matches nothing.
160  .TP  .TP
161    \fB--file-offsets\fP
162    Instead of showing lines or parts of lines that match, show each match as an
163    offset from the start of the file and a length, separated by a comma. In this
164    mode, no context is shown. That is, the \fB-A\fP, \fB-B\fP, and \fB-C\fP
165    options are ignored. If there is more than one match in a line, each of them is
166    shown separately. This option is mutually exclusive with \fB--line-offsets\fP
167    and \fB--only-matching\fP.
168    .TP
169  \fB-H\fP, \fB--with-filename\fP  \fB-H\fP, \fB--with-filename\fP
170  Force the inclusion of the filename at the start of output lines when searching  Force the inclusion of the filename at the start of output lines when searching
171  a single file. By default, the filename is not shown in this case. For matching  a single file. By default, the filename is not shown in this case. For matching
# Line 201  This option supplies a name to be used f Line 209  This option supplies a name to be used f
209  are being output. If not supplied, "(standard input)" is used. There is no  are being output. If not supplied, "(standard input)" is used. There is no
210  short form for this option.  short form for this option.
211  .TP  .TP
212    \fB--line-offsets\fP
213    Instead of showing lines or parts of lines that match, show each match as a
214    line number, the offset from the start of the line, and a length. The line
215    number is terminated by a colon (as usual; see the \fB-n\fP option), and the
216    offset and length are separated by a comma. In this mode, no context is shown.
217    That is, the \fB-A\fP, \fB-B\fP, and \fB-C\fP options are ignored. If there is
218    more than one match in a line, each of them is shown separately. This option is
219    mutually exclusive with \fB--file-offsets\fP and \fB--only-matching\fP.
220    .TP
221  \fB--locale\fP=\fIlocale-name\fP  \fB--locale\fP=\fIlocale-name\fP
222  This option specifies a locale to be used for pattern matching. It overrides  This option specifies a locale to be used for pattern matching. It overrides
223  the value in the \fBLC_ALL\fP or \fBLC_CTYPE\fP environment variables. If no  the value in the \fBLC_ALL\fP or \fBLC_CTYPE\fP environment variables. If no
# Line 241  being scanned does not agree with the co Line 258  being scanned does not agree with the co
258  \fB-n\fP, \fB--line-number\fP  \fB-n\fP, \fB--line-number\fP
259  Precede each output line by its line number in the file, followed by a colon  Precede each output line by its line number in the file, followed by a colon
260  and a space for matching lines or a hyphen and a space for context lines. If  and a space for matching lines or a hyphen and a space for context lines. If
261  the filename is also being output, it precedes the line number.  the filename is also being output, it precedes the line number. This option is
262    forced if \fB--line-offsets\fP is used.
263  .TP  .TP
264  \fB-o\fP, \fB--only-matching\fP  \fB-o\fP, \fB--only-matching\fP
265  Show only the part of the line that matched a pattern. In this mode, no  Show only the part of the line that matched a pattern. In this mode, no
# Line 249  context is shown. That is, the \fB-A\fP, Line 267  context is shown. That is, the \fB-A\fP,
267  ignored. If there is more than one match in a line, each of them is shown  ignored. If there is more than one match in a line, each of them is shown
268  separately. If \fB-o\fP is combined with \fB-v\fP (invert the sense of the  separately. If \fB-o\fP is combined with \fB-v\fP (invert the sense of the
269  match to find non-matching lines), no output is generated, but the return code  match to find non-matching lines), no output is generated, but the return code
270  is set appropriately.  is set appropriately. This option is mutually exclusive with
271    \fB--file-offsets\fP and \fB--line-offsets\fP.
272  .TP  .TP
273  \fB-q\fP, \fB--quiet\fP  \fB-q\fP, \fB--quiet\fP
274  Work quietly, that is, display nothing except error messages. The exit  Work quietly, that is, display nothing except error messages. The exit
# Line 391  Cambridge CB2 3QH, England. Line 410  Cambridge CB2 3QH, England.
410  .rs  .rs
411  .sp  .sp
412  .nf  .nf
413  Last updated: 04 December 2007  Last updated: 05 December 2007
414  Copyright (c) 1997-2007 University of Cambridge.  Copyright (c) 1997-2007 University of Cambridge.
415  .fi  .fi
Legend:
Removed from v.279  
changed lines
  Added in v.280
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12