Annotation of src/usr.bin/compress/zmore.1, Revision 1.13
1.13 ! millert 1: .\" $OpenBSD: zmore.1,v 1.12 2014/05/08 06:22:07 jmc Exp $
1.1 millert 2: .\"
1.13 ! millert 3: .\" Copyright (c) 2003 Todd C. Miller <millert@openbsd.org>
1.1 millert 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.13 ! millert 21: .Dd $Mdocdate: May 8 2014 $
1.1 millert 22: .Dt ZMORE 1
23: .Os
24: .Sh NAME
1.7 jsg 25: .Nm zmore ,
26: .Nm zless
1.5 jmc 27: .Nd view compressed files
1.1 millert 28: .Sh SYNOPSIS
29: .Nm zmore
30: .Op Ar flags
1.10 sobrado 31: .Op Ar
1.7 jsg 32: .Nm zless
33: .Op Ar flags
1.10 sobrado 34: .Op Ar
1.1 millert 35: .Sh DESCRIPTION
36: .Nm
37: is a filter that allows the viewing of files compressed with Lempel-Ziv
38: encoding.
39: Such files generally have a
40: .Dq Z
41: or
42: .Dq gz
43: extension (both the
44: .Xr compress 1
45: and
46: .Xr gzip 1
47: formats are supported).
48: Any
49: .Ar flags
1.11 zhuk 50: that are specified are passed to
51: .Xr more 1
52: or
53: .Xr less 1 ,
54: respectively.
1.1 millert 55: .Pp
1.7 jsg 56: .Nm zless
57: is equivalent to
58: .Nm zmore
59: but uses
60: .Xr less 1
61: as a pager instead of
62: .Xr more 1 .
63: .Pp
1.1 millert 64: When multiple files are specified,
65: .Nm
66: will pause at the end of each file and present the following prompt to the user:
67: .Bd -literal -offset indent
68: prev_file (END) - Next: next_file
69: .Ed
70: .Pp
71: Where
72: .Sy prev_file
73: is the file that was just displayed and
74: .Sy next_file
75: is the next file to be displayed.
76: The following keys are recognized at the prompt:
77: .Bl -tag -width "e or q" -offset indent
1.3 deraadt 78: .It Ic e No or Ic q
1.1 millert 79: quit
80: .Nm zmore .
1.3 deraadt 81: .It Ic s
1.1 millert 82: skip the next file (or exit if the next file is the last).
83: .El
84: .Pp
85: If no files are specified,
86: .Nm
87: will read from the standard input.
88: In this mode
89: .Nm
90: will assume
91: .Xr gzip 1
92: style compression since there is no suffix on which to make a decision.
93: .Sh SEE ALSO
1.2 jmc 94: .Xr compress 1 ,
1.6 jmc 95: .Xr gzip 1 ,
1.12 jmc 96: .Xr less 1 ,
1.2 jmc 97: .Xr more 1