10564b1175
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
125 lines
2.4 KiB
Groff
125 lines
2.4 KiB
Groff
.TH GREP 1
|
|
.SH NAME
|
|
grep, g \- search a file for a pattern
|
|
.SH SYNOPSIS
|
|
.B grep
|
|
[
|
|
.I option ...
|
|
]
|
|
.I pattern
|
|
[
|
|
.I file ...
|
|
]
|
|
.PP
|
|
.B g
|
|
[
|
|
.I option ...
|
|
]
|
|
.I pattern
|
|
[
|
|
.I file ...
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Grep\^
|
|
searches the input
|
|
.I files\^
|
|
(standard input default)
|
|
for lines that match the
|
|
.IR pattern ,
|
|
a regular expression as defined in
|
|
.MR regexp 7
|
|
with the addition of a newline character as an alternative
|
|
(substitute for
|
|
.BR | )
|
|
with lowest precedence.
|
|
Normally, each line matching the pattern is `selected',
|
|
and each selected line is copied to the standard output.
|
|
The options are
|
|
.TP
|
|
.B -c
|
|
Print only a count of matching lines.
|
|
.PD 0
|
|
.TP
|
|
.B -h
|
|
Do not print file name tags (headers) with output lines.
|
|
.TP
|
|
.B -e
|
|
The following argument is taken as a
|
|
.IR pattern .
|
|
This option makes it easy to specify patterns that
|
|
might confuse argument parsing, such as
|
|
.BR -n .
|
|
.TP
|
|
.B -i
|
|
Ignore alphabetic case distinctions. The implementation
|
|
folds into lower case all letters in the pattern and input before
|
|
interpretation. Matched lines are printed in their original form.
|
|
.TP
|
|
.B -l
|
|
(ell) Print the names of files with selected lines; don't print the lines.
|
|
.TP
|
|
.B -L
|
|
Print the names of files with no selected lines;
|
|
the converse of
|
|
.BR -l .
|
|
.TP
|
|
.B -n
|
|
Mark each printed line with its line number counted in its file.
|
|
.TP
|
|
.B -s
|
|
Produce no output, but return status.
|
|
.TP
|
|
.B -v
|
|
Reverse: print lines that do not match the pattern.
|
|
.TP
|
|
.B -f
|
|
The pattern argument is the name of a file containing regular
|
|
expressions one per line.
|
|
.TP
|
|
.B -b
|
|
Don't buffer the output: write each output line as soon as it is discovered.
|
|
.PD
|
|
.PP
|
|
Output lines are tagged by file name when there is more than one
|
|
input file.
|
|
(To force this tagging, include
|
|
.B /dev/null
|
|
as a file name argument.)
|
|
.PP
|
|
Care should be taken when
|
|
using the shell metacharacters
|
|
.B $*[^|()=\e
|
|
and newline
|
|
in
|
|
.IR pattern ;
|
|
it is safest to enclose the
|
|
entire expression
|
|
in single quotes
|
|
.BR \&\|' \|.\|.\|.\| ' .
|
|
An expression starting with '*'
|
|
will treat the rest of the expression
|
|
as literal characters.
|
|
.PP
|
|
.I G
|
|
invokes grep with
|
|
.B -n
|
|
and forces tagging of output lines by file name.
|
|
If no files are listed, it searches all files matching
|
|
.IP
|
|
.EX
|
|
*.C *.b *.c *.h *.m *.cc *.java *.cgi *.pl *.py *.tex *.ms
|
|
.EE
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/grep
|
|
.br
|
|
.B \*9/bin/g
|
|
.SH SEE ALSO
|
|
.MR ed 1 ,
|
|
.MR awk 1 ,
|
|
.MR sed 1 ,
|
|
.MR sam 1 ,
|
|
.MR regexp 7
|
|
.SH DIAGNOSTICS
|
|
Exit status is null if any lines are selected,
|
|
or non-null when no lines are selected or an error occurs.
|