annotate miscellany/compress-4.0/zmore.1 @ 0:bce86c4163a3

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