diff options
Diffstat (limited to 'bzmore.1')
-rw-r--r-- | bzmore.1 | 152 |
1 files changed, 152 insertions, 0 deletions
diff --git a/bzmore.1 b/bzmore.1 new file mode 100644 index 0000000..b437d3b --- /dev/null +++ b/bzmore.1 | |||
@@ -0,0 +1,152 @@ | |||
1 | .\"Shamelessly copied from zmore.1 by Philippe Troin <phil@fifi.org> | ||
2 | .\"for Debian GNU/Linux | ||
3 | .TH BZMORE 1 | ||
4 | .SH NAME | ||
5 | bzmore, bzless \- file perusal filter for crt viewing of bzip2 compressed text | ||
6 | .SH SYNOPSIS | ||
7 | .B bzmore | ||
8 | [ name ... ] | ||
9 | .br | ||
10 | .B bzless | ||
11 | [ name ... ] | ||
12 | .SH NOTE | ||
13 | In the following description, | ||
14 | .I bzless | ||
15 | and | ||
16 | .I less | ||
17 | can be used interchangeably with | ||
18 | .I bzmore | ||
19 | and | ||
20 | .I more. | ||
21 | .SH DESCRIPTION | ||
22 | .I Bzmore | ||
23 | is a filter which allows examination of compressed or plain text files | ||
24 | one screenful at a time on a soft-copy terminal. | ||
25 | .I bzmore | ||
26 | works on files compressed with | ||
27 | .I bzip2 | ||
28 | and also on uncompressed files. | ||
29 | If a file does not exist, | ||
30 | .I bzmore | ||
31 | looks for a file of the same name with the addition of a .bz2 suffix. | ||
32 | .PP | ||
33 | .I Bzmore | ||
34 | normally pauses after each screenful, printing --More-- | ||
35 | at the bottom of the screen. | ||
36 | If the user then types a carriage return, one more line is displayed. | ||
37 | If the user hits a space, | ||
38 | another screenful is displayed. Other possibilities are enumerated later. | ||
39 | .PP | ||
40 | .I Bzmore | ||
41 | looks in the file | ||
42 | .I /etc/termcap | ||
43 | to determine terminal characteristics, | ||
44 | and to determine the default window size. | ||
45 | On a terminal capable of displaying 24 lines, | ||
46 | the default window size is 22 lines. | ||
47 | Other sequences which may be typed when | ||
48 | .I bzmore | ||
49 | pauses, and their effects, are as follows (\fIi\fP is an optional integer | ||
50 | argument, defaulting to 1) : | ||
51 | .PP | ||
52 | .IP \fIi\|\fP<space> | ||
53 | display | ||
54 | .I i | ||
55 | more lines, (or another screenful if no argument is given) | ||
56 | .PP | ||
57 | .IP ^D | ||
58 | display 11 more lines (a ``scroll''). | ||
59 | If | ||
60 | .I i | ||
61 | is given, then the scroll size is set to \fIi\|\fP. | ||
62 | .PP | ||
63 | .IP d | ||
64 | same as ^D (control-D) | ||
65 | .PP | ||
66 | .IP \fIi\|\fPz | ||
67 | same as typing a space except that \fIi\|\fP, if present, becomes the new | ||
68 | window size. Note that the window size reverts back to the default at the | ||
69 | end of the current file. | ||
70 | .PP | ||
71 | .IP \fIi\|\fPs | ||
72 | skip \fIi\|\fP lines and print a screenful of lines | ||
73 | .PP | ||
74 | .IP \fIi\|\fPf | ||
75 | skip \fIi\fP screenfuls and print a screenful of lines | ||
76 | .PP | ||
77 | .IP "q or Q" | ||
78 | quit reading the current file; go on to the next (if any) | ||
79 | .PP | ||
80 | .IP "e or q" | ||
81 | When the prompt --More--(Next file: | ||
82 | .IR file ) | ||
83 | is printed, this command causes bzmore to exit. | ||
84 | .PP | ||
85 | .IP s | ||
86 | When the prompt --More--(Next file: | ||
87 | .IR file ) | ||
88 | is printed, this command causes bzmore to skip the next file and continue. | ||
89 | .PP | ||
90 | .IP = | ||
91 | Display the current line number. | ||
92 | .PP | ||
93 | .IP \fIi\|\fP/expr | ||
94 | search for the \fIi\|\fP-th occurrence of the regular expression \fIexpr.\fP | ||
95 | If the pattern is not found, | ||
96 | .I bzmore | ||
97 | goes on to the next file (if any). | ||
98 | Otherwise, a screenful is displayed, starting two lines before the place | ||
99 | where the expression was found. | ||
100 | The user's erase and kill characters may be used to edit the regular | ||
101 | expression. | ||
102 | Erasing back past the first column cancels the search command. | ||
103 | .PP | ||
104 | .IP \fIi\|\fPn | ||
105 | search for the \fIi\|\fP-th occurrence of the last regular expression entered. | ||
106 | .PP | ||
107 | .IP !command | ||
108 | invoke a shell with \fIcommand\|\fP. | ||
109 | The character `!' in "command" are replaced with the | ||
110 | previous shell command. The sequence "\\!" is replaced by "!". | ||
111 | .PP | ||
112 | .IP ":q or :Q" | ||
113 | quit reading the current file; go on to the next (if any) | ||
114 | (same as q or Q). | ||
115 | .PP | ||
116 | .IP . | ||
117 | (dot) repeat the previous command. | ||
118 | .PP | ||
119 | The commands take effect immediately, i.e., it is not necessary to | ||
120 | type a carriage return. | ||
121 | Up to the time when the command character itself is given, | ||
122 | the user may hit the line kill character to cancel the numerical | ||
123 | argument being formed. | ||
124 | In addition, the user may hit the erase character to redisplay the | ||
125 | --More-- message. | ||
126 | .PP | ||
127 | At any time when output is being sent to the terminal, the user can | ||
128 | hit the quit key (normally control\-\\). | ||
129 | .I Bzmore | ||
130 | will stop sending output, and will display the usual --More-- | ||
131 | prompt. | ||
132 | The user may then enter one of the above commands in the normal manner. | ||
133 | Unfortunately, some output is lost when this is done, due to the | ||
134 | fact that any characters waiting in the terminal's output queue | ||
135 | are flushed when the quit signal occurs. | ||
136 | .PP | ||
137 | The terminal is set to | ||
138 | .I noecho | ||
139 | mode by this program so that the output can be continuous. | ||
140 | What you type will thus not show on your terminal, except for the / and ! | ||
141 | commands. | ||
142 | .PP | ||
143 | If the standard output is not a teletype, then | ||
144 | .I bzmore | ||
145 | acts just like | ||
146 | .I bzcat, | ||
147 | except that a header is printed before each file. | ||
148 | .SH FILES | ||
149 | .DT | ||
150 | /etc/termcap Terminal data base | ||
151 | .SH "SEE ALSO" | ||
152 | more(1), less(1), bzip2(1), bzdiff(1), bzgrep(1) | ||