Annotation of src/usr.bin/comm/comm.1, Revision 1.1.1.1
1.1 deraadt 1: .\" $NetBSD: comm.1,v 1.4 1995/03/26 09:25:50 glass Exp $
2: .\"
3: .\" Copyright (c) 1989, 1990, 1993
4: .\" The Regents of the University of California. All rights reserved.
5: .\"
6: .\" This code is derived from software contributed to Berkeley by
7: .\" the Institute of Electrical and Electronics Engineers, Inc.
8: .\"
9: .\" Redistribution and use in source and binary forms, with or without
10: .\" modification, are permitted provided that the following conditions
11: .\" are met:
12: .\" 1. Redistributions of source code must retain the above copyright
13: .\" notice, this list of conditions and the following disclaimer.
14: .\" 2. Redistributions in binary form must reproduce the above copyright
15: .\" notice, this list of conditions and the following disclaimer in the
16: .\" documentation and/or other materials provided with the distribution.
17: .\" 3. All advertising materials mentioning features or use of this software
18: .\" must display the following acknowledgement:
19: .\" This product includes software developed by the University of
20: .\" California, Berkeley and its contributors.
21: .\" 4. Neither the name of the University nor the names of its contributors
22: .\" may be used to endorse or promote products derived from this software
23: .\" without specific prior written permission.
24: .\"
25: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35: .\" SUCH DAMAGE.
36: .\"
37: .\" @(#)comm.1 8.1 (Berkeley) 6/6/93
38: .\"
39: .Dd June 6, 1993
40: .Os
41: .Dt COMM 1
42: .Sh NAME
43: .Nm comm
44: .Nd select or reject lines common to two files
45: .Sh SYNOPSIS
46: .Nm comm
47: .Op Fl 123
48: .Ar file1 file2
49: .Sh DESCRIPTION
50: The
51: .Nm comm
52: utility reads
53: .Ar file1
54: and
55: .Ar file2 ,
56: which should be
57: sorted lexically, and produces three text
58: columns as output: lines only in
59: .Ar file1 ;
60: lines only in
61: .Ar file2 ;
62: and lines in both files.
63: .Pp
64: The filename ``-'' means the standard input.
65: .Pp
66: The following options are available:
67: .Bl -tag -width Ds
68: .It Fl 1
69: Suppress printing of column 1.
70: .It Fl 2
71: Suppress printing of column 2.
72: .It Fl 3
73: Suppress printing of column 3.
74: .El
75: .Pp
76: Each column will have a number of tab characters prepended to it
77: equal to the number of lower numbered columns that are being printed.
78: For example, if column number two is being suppressed, lines printed
79: in column number one will not have any tabs preceding them, and lines
80: printed in column number three will have one.
81: .Pp
82: .Nm Comm
83: assumes that the files are lexically sorted; all characters
84: participate in line comparisons.
85: .\" .Sh ENVIRONMENT
86: .\" .Bl -tag -width indent
87: .\" .It Ev LANG
88: .\" .It Ev LC_ALL
89: .\" .It Ev LC_CTYPE
90: .\" .It Ev LC_COLLATE
91: .\" .It Ev LC_MESSAGES
92: .\" .El
93: .Sh DIAGNOSTICS
94: .Nm Comm
95: exits 0 on success, >0 if an error occurred.
96: .Sh SEE ALSO
97: .Xr cmp 1 ,
98: .Xr diff 1 ,
99: .Xr sort 1 ,
100: .Xr uniq 1
101: .Sh STANDARDS
102: The
103: .Nm comm
104: utility conforms to
105: .St -p1003.2-92 .