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