[hackers] [sbase] Update grep(1) manpage and usage line || sin

From: <git_AT_suckless.org>
Date: Fri, 21 Nov 2014 14:12:08 +0100

commit 8d26936b83c17358e1707c53c22fdcfaeb54a767
Author: sin <sin_AT_2f30.org>
Date: Fri Nov 21 13:10:29 2014 +0000

    Update grep(1) manpage and usage line

diff --git a/grep.1 b/grep.1
index 9f0fa19..2f94be5 100644
--- a/grep.1
+++ b/grep.1
_AT_@ -1,80 +1,86 @@
-.TH GREP 1 sbase\-VERSION
-.SH NAME
-grep \- search files for a pattern
-.SH SYNOPSIS
-.B grep
-.RB [ \-EFHchilnqsvx ]
-.RB [ \-e
-.I pattern ]
-.RB [ \-f
-.I file ]
-.I pattern
-.RI [ file ...]
-.SH DESCRIPTION
-.B grep
+.Dd November 21, 2014
+.Dt GREP 1 sbase\-VERSION
+.Sh NAME
+.Nm grep
+.Nd search files for patterns
+.Sh SYNOPSIS
+.Nm grep
+.Op Fl EFHchilnqsvx
+.Op Fl e Ar pattern
+.Op Fl f Ar file
+.Op Ar pattern
+.Op Ar file ...
+.Sh DESCRIPTION
+.Nm
 searches the input files for lines that match the
-.IR pattern ,
+.Ar pattern ,
 a regular expression as defined in
-.IR regex (7).
-By default each matching line is printed to stdout. If no file is given, grep
+.Xr regex 7 .
+By default each matching line is printed to stdout. If no file is given
+.Nm
 reads from stdin.
-.P
-The status code is 0 if any lines match, and 1 if not. If an error occurred the
-status code is 2.
-.SH OPTIONS
-.TP
-.B \-E
-Matches using extended regex.
-.TP
-.B \-F
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl E
+Match using extended regex.
+.It Fl F
 Match using fixed strings. Treat each pattern specified as a string instead of a regular
 expression.
-.TP
-.B \-H
-Prefixes each matching line with its filename in the output. This is the
+.It Fl H
+Prefix each matching line with its filename in the output. This is the
 default when there is more than one file specified.
-.TP
-.B \-c
-Prints only a count of matching lines.
-.TP
-.B \-e pattern
+.It Fl c
+Print only a count of matching lines.
+.It Fl e Ar pattern
 Specify a pattern used during the search of the input: an input
 line is selected if it matches any of the specified patterns.
 This option is most useful when multiple -e options are used to
 specify multiple patterns, or when a pattern begins with a dash
-.TP
-.B \-f file
+.It Fl f Ar file
 Read one or more patterns from the file named by the pathname file.
 Patterns in file shall be terminated by a <newline>. A null pattern can be
 specified by an empty line in pattern_file. Unless the -E or -F option is
 also specified, each pattern shall be treated as a BRE.
 (`-').
-.TP
-.B \-h
+.It Fl h
 Do not prefix each line with 'filename:' prefix.
-.TP
-.B \-i
-Matches lines case insensitively.
-.TP
-.B \-l
-Prints only the names of files with matching lines.
-.TP
-.B \-n
-Prefixes each matching line with its line number in the input.
-.TP
-.B \-q
-Prints nothing, only returns status.
-.TP
-.B \-s
+.It Fl i
+Match lines case insensitively.
+.It Fl l
+Print only the names of files with matching lines.
+.It Fl n
+Prefix each matching line with its line number in the input.
+.It Fl q
+Print nothing, only returns status.
+.It Fl s
 Suppress the error messages ordinarily written for nonexistent or unreadable files.
-.TP
-.B \-v
-Selects lines which do
+.It Fl v
+Select lines which do
 .B not
 Match the pattern.
-.TP
-.B \-x
+.It Fl x
 Consider only input lines that use all characters in the line excluding the terminating <newline> to
 match an entire fixed string or regular expression to be matching lines.
-.SH SEE ALSO
-.IR regex (7)
+.El
+.Sh EXIT STATUS
+.Bl -tag -width Ds
+.It 0
+One or more lines were matched.
+.It 1
+No lines were matched.
+.It > 1
+An error occurred.
+.El
+.Sh SEE ALSO
+.Xr regex 7 ,
+.Xr sed 1
+.Sh STANDARDS
+The
+.Nm
+utility is compliant with the
+.St -p1003.1-2008
+specification.
+.Pp
+The flags
+.Op Fl Hh
+are an extension to that specification.
diff --git a/grep.c b/grep.c
index 5aa5816..c9c3ac1 100644
--- a/grep.c
+++ b/grep.c
_AT_@ -39,7 +39,7 @@ static SLIST_HEAD(phead, pattern) phead;
 static void
 usage(void)
 {
- enprintf(Error, "usage: %s [-EFHcilnqsvx] [-e pattern] [-f file] pattern [files...]\n", argv0);
+ enprintf(Error, "usage: %s [-EFHcilnqsvx] [-e pattern] [-f file] [pattern] [file ...]\n", argv0);
 }
 
 int
Received on Fri Nov 21 2014 - 14:12:08 CET

This archive was generated by hypermail 2.3.0 : Fri Nov 21 2014 - 14:12:23 CET