Annotation of src/usr.bin/compress/zdiff.1, Revision 1.3
1.3 ! jmc 1: .\" $OpenBSD: zdiff.1,v 1.2 2003/07/13 17:39:14 millert Exp $
1.1 millert 2: .\"
3: .\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
4: .\"
5: .\" Permission to use, copy, modify, and distribute this software for any
6: .\" purpose with or without fee is hereby granted, provided that the above
7: .\" copyright notice and this permission notice appear in all copies.
8: .\"
9: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16: .\"
17: .\" Sponsored in part by the Defense Advanced Research Projects
18: .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
19: .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
20: .\"
21: .Dd June 23, 2003
22: .Dt ZDIFF 1
23: .Os
24: .Sh NAME
25: .Nm zcmp ,
26: .Nm zdiff
27: .Nd compare compressed files
28: .Sh SYNOPSIS
29: .Nm zcmp
30: .Op Ar options
31: .Ar file
32: .Op Ar file2
33: .Nm zdiff
34: .Op Ar options
35: .Ar file
36: .Op Ar file2
37: .Sh DESCRIPTION
38: .Nm zcmp
39: and
40: .Nm zdiff
41: are filters that invoke
42: .Xr cmp 1
43: or
44: .Xr diff 1
45: respectively to compare compressed files.
46: Such files generally have a
47: .Dq Z
48: or
49: .Dq gz
50: extension (both the
51: .Xr compress 1
52: and
53: .Xr gzip 1
54: formats are supported).
55: Any
56: .Ar options
57: that are specified are passed to
58: .Xr cmp 1
59: or
60: .Xr diff 1 .
61: .Pp
62: If only
63: .Ar file1
64: is specified, it is compared against a file with the same name, but
65: with the extension removed.
66: When both
67: .Ar file1
68: or
69: .Ar file2
70: are specified, either file may be compressed.
71: .Sh ENVIRONMENT
72: .Bl -tag -width "TMPDIR"
73: .It Ev TMPDIR
74: Directory in which to place temporary files.
75: If unset,
76: .Pa /tmp
77: is used.
78: .El
79: .Sh FILES
1.2 millert 80: .Bl -tag -width "/tmp/zdiff.XXXXXXXXXX" -compact
1.1 millert 81: .It Pa /tmp/zcmp.XXXXXXXXXX
82: Temporary file for
83: .Nm zcmp .
84: .It Pa /tmp/zdiff.XXXXXXXXXX
85: Temporary file for
86: .Nm zdiff .
87: .El
88: .Sh SEE ALSO
89: .Xr cmp 1 ,
90: .Xr compress 1 ,
91: .Xr diff 1
92: .Sh CAVEATS
93: .Nm zcmp
94: and
95: .Nm zdiff
1.2 millert 96: rely solely on the file extension to determine what is, or is not,
1.1 millert 97: a compressed file.
98: Consequently, the following are not supported as arguments:
1.2 millert 99: .Bl -dash
1.1 millert 100: .It
101: directories
102: .It
103: device special files
104: .It
1.3 ! jmc 105: filenames indicating the standard input
! 106: .Pq Dq \-
1.1 millert 107: .El