maint: fix port to s390x
[gzip.git] / zmore.1
blobc387dd1a4ea9075ca21f5936040b4d1bcc4a068f
1 .TH ZMORE 1
2 .SH NAME
3 zmore \- file perusal filter for crt viewing of compressed text
4 .SH SYNOPSIS
5 .B zmore
6 [ name ...  ]
7 .SH DESCRIPTION
8 The
9 .I zmore
10 command
11 is a filter which allows examination of compressed or plain text files
12 one screenful at a time on a soft-copy terminal.
13 The
14 .B zmore
15 command
16 works on files compressed with
17 .BR compress ,
18 .B pack
20 .BR gzip ,
21 and also on uncompressed files.
22 If a file does not exist,
23 .B zmore
24 looks for a file of the same name with the addition of a .gz, .z or .Z suffix.
25 .PP
26 The
27 .B zmore
28 command
29 normally pauses after each screenful, printing --More--
30 at the bottom of the screen.
31 If the user then types a carriage return, one more line is displayed.
32 If the user hits a space,
33 another screenful is displayed.  Other possibilities are enumerated later.
34 .PP
35 The
36 .B zmore
37 command
38 looks in the file
39 .I /etc/termcap
40 to determine terminal characteristics,
41 and to determine the default window size.
42 On a terminal capable of displaying 24 lines,
43 the default window size is 22 lines.
44 To use a pager other than the default
45 .BR more ,
46 set environment variable PAGER to the name of the desired program, such as
47 .BR less .
48 .PP
49 Other sequences which may be typed when
50 .B zmore
51 pauses, and their effects, are as follows (\fIi\fP is an optional integer
52 argument, defaulting to 1) :
53 .PP
54 .IP \fIi\^\fP<space>
55 display
56 .I i
57 more lines, (or another screenful if no argument is given)
58 .PP
59 .IP ^D
60 display 11 more lines (a ``scroll'').
62 .I i
63 is given, then the scroll size is set to \fIi\fP.
64 .PP
65 .IP d
66 same as ^D (control-D)
67 .PP
68 .IP \fIi\^\fPz
69 same as typing a space except that \fIi\fP, if present, becomes the new
70 window size.
71 .PP
72 .IP \fIi\^\fPs
73 skip \fIi\fP lines and print a screenful of lines
74 .PP
75 .IP \fIi\^\fPf
76 skip \fIi\fP screenfuls and print a screenful of lines
77 .PP
78 .IP "q or Q"
79 Quit.
80 .PP
81 .IP =
82 Display the current line number.
83 .PP
84 .IP \fIi\fP/expr
85 search for the \fIi\^\fP-th occurrence of the regular expression \fIexpr.\fP
86 The user's erase and kill characters may be used to edit the regular
87 expression.
88 Erasing back past the first column cancels the search command.
89 .PP
90 .IP \fIi\^\fPn
91 search for the \fIi\^\fP-th occurrence of the last regular expression entered.
92 .PP
93 .IP !command
94 invoke a shell with \fIcommand\fP.
95 The character `!' in "command" is replaced with the
96 previous shell command.  The sequence "\\!" is replaced by "!".
97 .PP
98 .IP ":q or :Q"
99 Quit
100 (same as q or Q).
102 .IP .
103 (dot) repeat the previous command.
105 The commands take effect immediately, i.e., it is not necessary to
106 type a carriage return.
107 Up to the time when the command character itself is given,
108 the user may hit the line kill character to cancel the numerical
109 argument being formed.
110 In addition, the user may hit the erase character to redisplay the
111 --More-- message.
113 At any time when output is being sent to the terminal, the user can
114 hit the quit key (normally control\-\\).
116 .I zmore
117 command
118 will stop sending output, and will display the usual --More--
119 prompt.
120 The user may then enter one of the above commands in the normal manner.
121 Unfortunately, some output is lost when this is done, due to the
122 fact that any characters waiting in the terminal's output queue
123 are flushed when the quit signal occurs.
125 The terminal is set to
126 .I noecho
127 mode by this program so that the output can be continuous.
128 What you type will thus not show on your terminal, except for the / and !
129 commands.
131 If the standard output is not a teletype, then
132 .B zmore
133 acts just like
134 .BR zcat ,
135 except that a header is printed before each file
136 if there is more than one file.
137 .SH FILES
139 /etc/termcap
140 Terminal data base
141 .SH "SEE ALSO"
142 .BR more (1),
143 .BR gzip (1),
144 .BR zdiff (1),
145 .BR zgrep (1),
146 .BR znew (1),
147 .BR zforce (1),
148 .BR gzexe (1)