/[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 375 by ph10, Sat Mar 8 17:13:02 2008 UTC revision 376 by ph10, Sun Mar 1 12:00:59 2009 UTC
# Line 115  If data is required, it must be given in Line 115  If data is required, it must be given in
115  equals sign.  equals sign.
116  .TP  .TP
117  \fB--colour=\fP\fIvalue\fP, \fB--color=\fP\fIvalue\fP  \fB--colour=\fP\fIvalue\fP, \fB--color=\fP\fIvalue\fP
118  This option specifies under what circumstances the part of a line that matched  This option specifies under what circumstances the parts of a line that matched
119  a pattern should be coloured in the output. The value may be "never" (the  a pattern should be coloured in the output. By default, the output is not
120  default), "always", or "auto". In the latter case, colouring happens only if  coloured. The value (which is optional, see above) may be "never", "always", or
121  the standard output is connected to a terminal. The colour can be specified by  "auto". In the latter case, colouring happens only if the standard output is
122  setting the environment variable PCREGREP_COLOUR or PCREGREP_COLOR. The value  connected to a terminal. The colour that is used can be specified by setting
123  of this variable should be a string of two numbers, separated by a semicolon.  the environment variable PCREGREP_COLOUR or PCREGREP_COLOR. The value of this
124  They are copied directly into the control string for setting colour on a  variable should be a string of two numbers, separated by a semicolon. They are
125  terminal, so it is your responsibility to ensure that they make sense. If  copied directly into the control string for setting colour on a terminal, so it
126  neither of the environment variables is set, the default is "1;31", which gives  is your responsibility to ensure that they make sense. If neither of the
127  red.  environment variables is set, the default is "1;31", which gives red.
128  .TP  .TP
129  \fB-D\fP \fIaction\fP, \fB--devices=\fP\fIaction\fP  \fB-D\fP \fIaction\fP, \fB--devices=\fP\fIaction\fP
130  If an input path is not a regular file or a directory, "action" specifies how  If an input path is not a regular file or a directory, "action" specifies how
# Line 204  and \fB--only-matching\fP. Line 204  and \fB--only-matching\fP.
204  \fB-H\fP, \fB--with-filename\fP  \fB-H\fP, \fB--with-filename\fP
205  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
206  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
207  lines, the filename is followed by a colon and a space; for context lines, a  lines, the filename is followed by a colon; for context lines, a hyphen
208  hyphen separator is used. If a line number is also being output, it follows the  separator is used. If a line number is also being output, it follows the file
209  file name without a space.  name.
210  .TP  .TP
211  \fB-h\fP, \fB--no-filename\fP  \fB-h\fP, \fB--no-filename\fP
212  Suppress the output filenames when searching multiple files. By default,  Suppress the output filenames when searching multiple files. By default,
213  filenames are shown when multiple files are searched. For matching lines, the  filenames are shown when multiple files are searched. For matching lines, the
214  filename is followed by a colon and a space; for context lines, a hyphen  filename is followed by a colon; for context lines, a hyphen separator is used.
215  separator is used. If a line number is also being output, it follows the file  If a line number is also being output, it follows the file name.
 name without a space.  
216  .TP  .TP
217  \fB--help\fP  \fB--help\fP
218  Output a help message, giving brief details of the command options and file  Output a help message, giving brief details of the command options and file
# Line 305  being scanned does not agree with the co Line 304  being scanned does not agree with the co
304  .TP  .TP
305  \fB-n\fP, \fB--line-number\fP  \fB-n\fP, \fB--line-number\fP
306  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
307  and a space for matching lines or a hyphen and a space for context lines. If  for matching lines or a hyphen for context lines. If the filename is also being
308  the filename is also being output, it precedes the line number. This option is  output, it precedes the line number. This option is forced if
309  forced if \fB--line-offsets\fP is used.  \fB--line-offsets\fP is used.
310  .TP  .TP
311  \fB-o\fP, \fB--only-matching\fP  \fB-o\fP, \fB--only-matching\fP
312  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 458  Cambridge CB2 3QH, England. Line 457  Cambridge CB2 3QH, England.
457  .rs  .rs
458  .sp  .sp
459  .nf  .nf
460  Last updated: 08 March 2008  Last updated: 01 March 2009
461  Copyright (c) 1997-2008 University of Cambridge.  Copyright (c) 1997-2009 University of Cambridge.
462  .fi  .fi
Legend:
Removed from v.375  
changed lines
  Added in v.376
  ViewVC Help
Powered by ViewVC 1.1.5