xref: /dragonfly/usr.bin/gzip/zmore.1 (revision c8860c9a)
1.\"	$NetBSD: zmore.1,v 1.2 2003/12/28 12:43:43 wiz Exp $
2.\"	$OpenBSD: zmore.1,v 1.9 2007/05/31 19:20:09 jmc Exp $
3.\"
4.\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
5.\"
6.\" Permission to use, copy, modify, and distribute this software for any
7.\" purpose with or without fee is hereby granted, provided that the above
8.\" copyright notice and this permission notice appear in all copies.
9.\"
10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17.\"
18.\" Sponsored in part by the Defense Advanced Research Projects
19.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
20.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
21.\"
22.Dd July 18, 2009
23.Dt ZMORE 1
24.Os
25.Sh NAME
26.Nm zmore
27.Nd view compressed files
28.Sh SYNOPSIS
29.Nm
30.Op Ar flags
31.Op Ar file ...
32.Sh DESCRIPTION
33.Nm
34is a filter that allows the viewing of files compressed with Lempel-Ziv
35encoding.
36Such files generally have a
37.Dq Z
38or
39.Dq gz
40extension (both the
41.Xr compress 1
42and
43.Xr gzip 1
44formats are supported).
45Any
46.Ar flags
47that are specified are passed to the user's preferred
48.Ev PAGER
49(which is
50.Pa /usr/bin/more
51by default).
52.Pp
53When multiple files are specified,
54.Nm
55will pause at the end of each file and present the following prompt to the user:
56.Bd -literal -offset indent
57prev_file (END) - Next: next_file
58.Ed
59.Pp
60Where
61.Sy prev_file
62is the file that was just displayed and
63.Sy next_file
64is the next file to be displayed.
65The following keys are recognized at the prompt:
66.Bl -tag -width "e or q" -offset indent
67.It Ic e No or Ic q
68quit
69.Nm .
70.It Ic s
71skip the next file (or exit if the next file is the last).
72.El
73.Pp
74If no files are specified,
75.Nm
76will read from the standard input.
77In this mode
78.Nm
79will assume
80.Xr gzip 1
81style compression since there is no suffix on which to make a decision.
82.Sh ENVIRONMENT
83.Bl -tag -width "PAGER"
84.It Ev PAGER
85Program used to display files.
86If unset,
87.Pa /usr/bin/more
88is used.
89.El
90.Sh SEE ALSO
91.Xr gzip 1 ,
92.Xr less 1 ,
93.Xr more 1
94