Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / miscellany / compress-4.0 / zmore.1
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 .I  Zmore
9 is a filter which allows examination of compressed text files
10 one screenful at a time on a soft-copy terminal.
11 It normally pauses after each screenful, printing --More--
12 at the bottom of the screen.
13 If the user then types a carriage return, one more line is displayed.
14 If the user hits a space,
15 another screenful is displayed.  Other possibilites are enumerated later.
16 .PP
17 .I Zmore
18 looks in the file
19 .I /etc/termcap
20 to determine terminal characteristics,
21 and to determine the default window size.
22 On a terminal capable of displaying 24 lines,
23 the default window size is 22 lines.
24 .PP
25 Other sequences which may be typed when
26 .I zmore
27 pauses, and their effects, are as follows (\fIi\fP is an optional integer
28 argument, defaulting to 1) :
29 .PP
30 .IP \fIi\|\fP<space>
31 display
32 .I i
33 more lines, (or another screenful if no argument is given)
34 .PP
35 .IP ^D
36 display 11 more lines (a ``scroll'').
37 If
38 .I i
39 is given, then the scroll size is set to \fIi\|\fP.
40 .PP
41 .IP d
42 same as ^D (control-D)
43 .PP
44 .IP \fIi\|\fPz
45 same as typing a space except that \fIi\|\fP, if present, becomes the new
46 window size.  Note that the window size reverts back to the default at the
47 end of the current file.
48 .PP
49 .IP \fIi\|\fPs
50 skip \fIi\|\fP lines and print a screenful of lines
51 .PP
52 .IP \fIi\|\fPf
53 skip \fIi\fP screenfuls and print a screenful of lines
54 .PP
55 .IP "q or Q"
56 quit reading the current file; go on to the next (if any)
57 .PP
58 .IP e
59 When the prompt --More--(Next file: 
60 .IR file )
61 is printed, this command causes zmore to exit.
62 .PP 
63 .IP =
64 Display the current line number.
65 .PP
66 .IP \fIi\|\fP/expr
67 search for the \fIi\|\fP-th occurrence of the regular expression \fIexpr.\fP
68 If the pattern is not found,
69 .I zmore
70 goes on to the next file (if any).
71 Otherwise, a screenful is displayed, starting two lines before the place
72 where the expression was found.
73 The user's erase and kill characters may be used to edit the regular
74 expression.
75 Erasing back past the first column cancels the search command.
76 .PP
77 .IP \fIi\|\fPn
78 search for the \fIi\|\fP-th occurrence of the last regular expression entered.
79 .PP
80 .IP !command
81 invoke a shell with \fIcommand\|\fP. 
82 The character `!' in "command" are replaced with the
83 the previous shell command.  The sequence "\\!" is replaced by "!".
84 .PP
85 .IP ":q or :Q"
86 quit reading the current file; go on to the next (if any)
87 (same as q or Q).
88 .PP
89 .IP .
90 (dot) repeat the previous command.
91 .PP
92 The commands take effect immediately, i.e., it is not necessary to
93 type a carriage return.
94 Up to the time when the command character itself is given,
95 the user may hit the line kill character to cancel the numerical
96 argument being formed.
97 In addition, the user may hit the erase character to redisplay the
98 --More-- message.
99 .PP
100 At any time when output is being sent to the terminal, the user can
101 hit the quit key (normally control\-\\).
102 .I Zmore
103 will stop sending output, and will display the usual --More--
104 prompt.
105 The user may then enter one of the above commands in the normal manner.
106 Unfortunately, some output is lost when this is done, due to the
107 fact that any characters waiting in the terminal's output queue
108 are flushed when the quit signal occurs.
109 .PP
110 The terminal is set to
111 .I noecho
112 mode by this program so that the output can be continuous.
113 What you type will thus not show on your terminal, except for the / and !
114 commands.
115 .PP
116 If the standard output is not a teletype, then
117 .I zmore
118 acts just like
119 .I zcat,
120 except that a header is printed before each file.
121 .SH FILES
122 .DT
123 /etc/termcap            Terminal data base
124 .SH "SEE ALSO"
125 more(1), zcat(1), compress(1), uncompress(1)