break out special local mail processing (e.g., mapping to the

[unix-history] / usr / src / usr.bin / uniq / uniq.1

diff --git a/usr/src/usr.bin/uniq/uniq.1 b/usr/src/usr.bin/uniq/uniq.1
index 311fc6c..d033430 100644 (file)
--- a/usr/src/usr.bin/uniq/uniq.1
+++ b/usr/src/usr.bin/uniq/uniq.1
@@ -1,62 +1,104 @@
-.\"    @(#)uniq.1      5.1 (Berkeley) %G%
+.\" Copyright (c) 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.TH UNIQ 1  "10 February 1983"
-.AT 3
-.SH NAME
-uniq \- report repeated lines in a file
-.SH SYNOPSIS
-.B uniq
-[
-.B \-udc
-[
-.BR + n
-] [
-.BR \- n
-]
-] [ input [ output ] ]
-.SH DESCRIPTION
-.I Uniq
-reads the input file comparing adjacent lines.
-In the normal case, the second and succeeding copies of repeated lines are
-removed; the remainder is written on the output file.
-Note that repeated lines must be adjacent in order to be found; see
-.IR  sort (1).
-If the
-.B \-u
-flag is used, just the lines that are not repeated
-in the original file are output.  The
-.B \-d
-option specifies that one copy of just the repeated lines is to be written.
-The normal mode output is the union of the
-.B \-u
-and
-.B \-d
-mode outputs.
-.PP
+.\" This code is derived from software contributed to Berkeley by
+.\" the Institute of Electrical and Electronics Engineers, Inc.
+.\"
+.\" %sccs.include.redist.roff%
+.\"
+.\"     @(#)uniq.1     8.1 (Berkeley) %G%
+.\"
+.Dd 
+.Dt UNIQ 1
+.Os
+.Sh NAME
+.Nm uniq
+.Nd report or filter out repeated lines in a file
+.Sh SYNOPSIS
+.Nm uniq
+.Op Fl c | Fl d | Fl u
+.Op Fl f Ar fields
+.Op Fl s Ar chars
+.Oo
+.Ar input_file
+.Op Ar output_file
+.Oc
+.Sh DESCRIPTION
+The
+.Nm uniq
+utility reads the standard input comparing adjacent lines, and writes
+a copy of each unique input line to the standard output.
+The second and succeeding copies of identical adjacent input lines are
+not written.
+Repeated lines in the input will not be detected if they are not adjacent,
+so it may be necessary to sort the files first.
+.Pp
+The following options are available:
+.Bl -tag -width Ds
+.It Fl c
+Precede each output line with the count of the number of times the line
+occurred in the input, followed by a single space.
+.It Fl d
+Don't output lines that are not repeated in the input.
+.It Fl f Ar fields
+Ignore the first
+.Ar fields
+in each input line when doing comparisons.
+A field is a string of non-blank characters separated from adjacent fields
+by blanks.
+Field numbers are one based, i.e. the first field is field one.
+.It Fl s Ar chars
+Ignore the first
+.Ar chars
+characters in each input line when doing comparisons.
+If specified in conjunction with the
+.Fl f
+option, the first
+.Ar chars
+characters after the first
+.Ar fields
+fields will be ignored.
+Character numbers are one based, i.e. the first character is character one.
+.It Fl u
+Don't output lines that are repeated in the input.
+.\".It Fl Ns Ar n
+.\"(Deprecated; replaced by
+.\".Fl f ) .
+.\"Ignore the first n
+.\"fields on each input line when doing comparisons,
+.\"where n is a number.
+.\"A field is a string of non-blank
+.\"characters separated from adjacent fields
+.\"by blanks.
+.\".It Cm \&\(pl Ns Ar n
+.\"(Deprecated; replaced by
+.\".Fl s ) .
+.\"Ignore the first
+.\".Ar m
+.\"characters when doing comparisons, where
+.\".Ar m
+.\"is a
+.\"number.
+.El
+.Pp
+If additional arguments are specified on the command line, the first
+such argument is used as the name of an input file, the second is used
+as the name of an output file.
+.Pp

 The
 The

-.B \-c
-option supersedes
-.B \-u
+.Nm uniq
+utility exits 0 on success, and >0 if an error occurs.
+.Sh COMPATIBILITY
+The historic
+.Cm \&\(pl Ns Ar number

 and
 and

-.B \-d
-and generates an output report in default style
-but with each line preceded by a count of the number of times it occurred.
-.PP
+.Fl Ns Ar number
+options have been deprecated but are still supported in this implementation.
+.Sh SEE ALSO
+.Xr sort 1
+.Sh STANDARDS

 The
 The

-.I n
-arguments specify skipping an initial portion of each line in the comparison:
-.TP 8
-.BI \- n
-The first
-.IR n 
-fields together with any blanks before each are ignored.
-A field is defined as a string of non-space, non-tab characters
-separated by tabs and spaces from its neighbors.
-.TP 8
-.BI + n
-The first
-.IR n 
-characters are ignored.  Fields are skipped before characters.
-.PP
-.SH "SEE ALSO"
-sort(1), comm(1)
+.Nm uniq
+utility is expected to be
+.St -p1003.2
+compatible.