/[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 91 by nigel, Sat Feb 24 21:41:34 2007 UTC revision 93 by nigel, Sat Feb 24 21:41:42 2007 UTC
# Line 11  pcregrep - a grep with Perl-compatible r Line 11  pcregrep - a grep with Perl-compatible r
11  grep commands do, but it uses the PCRE regular expression library to support  grep commands do, but it uses the PCRE regular expression library to support
12  patterns that are compatible with the regular expressions of Perl 5. See  patterns that are compatible with the regular expressions of Perl 5. See
13  .\" HREF  .\" HREF
14  \fBpcrepattern\fP  \fBpcrepattern\fP(3)
15  .\"  .\"
16  for a full description of syntax and semantics of the regular expressions that  for a full description of syntax and semantics of the regular expressions
17  PCRE supports.  that PCRE supports.
18  .P  .P
19  Patterns, whether supplied on the command line or in a separate file, are given  Patterns, whether supplied on the command line or in a separate file, are given
20  without delimiters. For example:  without delimiters. For example:
# Line 220  the previous 8K characters (or all the p Line 220  the previous 8K characters (or all the p
220  are guaranteed to be available for lookbehind assertions.  are guaranteed to be available for lookbehind assertions.
221  .TP  .TP
222  \fB-N\fP \fInewline-type\fP, \fB--newline=\fP\fInewline-type\fP  \fB-N\fP \fInewline-type\fP, \fB--newline=\fP\fInewline-type\fP
223  The PCRE library supports three different character sequences for indicating  The PCRE library supports four different conventions for indicating
224  the ends of lines. They are the single-character sequences CR (carriage return)  the ends of lines. They are the single-character sequences CR (carriage return)
225  and LF (linefeed), and the two-character sequence CR, LF. When the library is  and LF (linefeed), the two-character sequence CRLF, and an "any" convention, in
226  built, a default line-ending sequence is specified. This is normally the  which any Unicode line ending sequence is assumed to end a line. The Unicode
227  standard sequence for the operating system. Unless otherwise specified by this  sequences are the three just mentioned, plus VT (vertical tab, U+000B), FF
228  option, \fBpcregrep\fP uses the default. The possible values for this option  (formfeed, U+000C), NEL (next line, U+0085), LS (line separator, U+2028), and
229  are CR, LF, or CRLF. This makes it possible to use \fBpcregrep\fP on files that  PS (paragraph separator, U+0029).
230  have come from other environments without having to modify their line endings.  .sp
231  If the data that is being scanned does not agree with the convention set by  When the PCRE library is built, a default line-ending sequence is specified.
232  this option, \fBpcregrep\fP may behave in strange ways.  This is normally the standard sequence for the operating system. Unless
233    otherwise specified by this option, \fBpcregrep\fP uses the library's default.
234    The possible values for this option are CR, LF, CRLF, or ANY. This makes it
235    possible to use \fBpcregrep\fP on files that have come from other environments
236    without having to modify their line endings. If the data that is being scanned
237    does not agree with the convention set by this option, \fBpcregrep\fP may
238    behave in strange ways.
239  .TP  .TP
240  \fB-n\fP, \fB--line-number\fP  \fB-n\fP, \fB--line-number\fP
241  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
# Line 339  in the first form, using an equals chara Line 345  in the first form, using an equals chara
345  it has no data.  it has no data.
346  .  .
347  .  .
348  .SH MATCHING ERRORS  .SH "MATCHING ERRORS"
349  .rs  .rs
350  .sp  .sp
351  It is possible to supply a regular expression that takes a very long time to  It is possible to supply a regular expression that takes a very long time to
# Line 361  suppress error messages about inaccessbl Line 367  suppress error messages about inaccessbl
367  code.  code.
368  .  .
369  .  .
370    .SH "SEE ALSO"
371    .rs
372    .sp
373    \fBpcrepattern\fP(3), \fBpcretest\fP(1).
374    .
375    .
376  .SH AUTHOR  .SH AUTHOR
377  .rs  .rs
378  .sp  .sp
# Line 368  Philip Hazel Line 380  Philip Hazel
380  .br  .br
381  University Computing Service  University Computing Service
382  .br  .br
383  Cambridge CB2 3QG, England.  Cambridge CB2 3QH, England.
384  .P  .P
385  .in 0  .in 0
386  Last updated: 06 June 2006  Last updated: 29 November 2006
387  .br  .br
388  Copyright (c) 1997-2006 University of Cambridge.  Copyright (c) 1997-2006 University of Cambridge.
Legend:
Removed from v.91  
changed lines
  Added in v.93
  ViewVC Help
Powered by ViewVC 1.1.5