Return to zdiff.1 CVS log

Up to [local] / src / usr.bin / compress

Annotation of src/usr.bin/compress/zdiff.1, Revision 1.6

1.6     ! jmc         1: .\"    $OpenBSD: zdiff.1,v 1.5 2007/01/24 10:53:43 jmc 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: .\"
1.6     ! jmc        21: .Dd $Mdocdate$
1.1       millert    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
1.4       jmc        31: .Ar file1
1.1       millert    32: .Op Ar file2
                     33: .Nm zdiff
                     34: .Op Ar options
1.4       jmc        35: .Ar file1
1.1       millert    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 ,
1.5       jmc        91: .Xr diff 1 ,
                     92: .Xr gzip 1
1.1       millert    93: .Sh CAVEATS
                     94: .Nm zcmp
                     95: and
                     96: .Nm zdiff
1.2       millert    97: rely solely on the file extension to determine what is, or is not,
1.1       millert    98: a compressed file.
                     99: Consequently, the following are not supported as arguments:
1.4       jmc       100: .Pp
                    101: .Bl -dash -offset indent -compact
1.1       millert   102: .It
                    103: directories
                    104: .It
                    105: device special files
                    106: .It
1.3       jmc       107: filenames indicating the standard input
1.4       jmc       108: .Pq Sq -
1.1       millert   109: .El