Annotation of src/usr.bin/compress/zmore.1, Revision 1.3
1.3 ! deraadt 1: .\" $OpenBSD: zmore.1,v 1.2 2003/06/23 20:43:33 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: .\"
21: .Dd June 23, 2003
22: .Dt ZMORE 1
23: .Os
24: .Sh NAME
25: .Nm zmore
26: .Nd view compressed files on a crt
27: .Sh SYNOPSIS
28: .Nm zmore
29: .Op Ar flags
30: .Op Ar file ...
31: .Sh DESCRIPTION
32: .Nm
33: is a filter that allows the viewing of files compressed with Lempel-Ziv
34: encoding.
35: Such files generally have a
36: .Dq Z
37: or
38: .Dq gz
39: extension (both the
40: .Xr compress 1
41: and
42: .Xr gzip 1
43: formats are supported).
44: Any
45: .Ar flags
46: that are specified are passed to the user's preferred
47: .Ev PAGER
1.3 ! deraadt 48: (which is
! 49: .Pa /usr/bin/more
1.1 millert 50: by default).
51: .Pp
52: When multiple files are specified,
53: .Nm
54: will pause at the end of each file and present the following prompt to the user:
55: .Bd -literal -offset indent
56: prev_file (END) - Next: next_file
57: .Ed
58: .Pp
59: Where
60: .Sy prev_file
61: is the file that was just displayed and
62: .Sy next_file
63: is the next file to be displayed.
64: The following keys are recognized at the prompt:
65: .Bl -tag -width "e or q" -offset indent
1.3 ! deraadt 66: .It Ic e No or Ic q
1.1 millert 67: quit
68: .Nm zmore .
1.3 ! deraadt 69: .It Ic s
1.1 millert 70: skip the next file (or exit if the next file is the last).
71: .El
72: .Pp
73: If no files are specified,
74: .Nm
75: will read from the standard input.
76: In this mode
77: .Nm
78: will assume
79: .Xr gzip 1
80: style compression since there is no suffix on which to make a decision.
81: .Sh ENVIRONMENT
82: .Bl -tag -width "PAGER"
83: .It Ev PAGER
84: Program used to display files.
85: If unset,
86: .Pa /usr/bin/more
87: is used.
88: .El
89: .Sh SEE ALSO
1.2 jmc 90: .Xr compress 1 ,
1.1 millert 91: .Xr less 1 ,
1.2 jmc 92: .Xr more 1