| 1 |
.\"Shamelessly copied from zmore.1 by Philippe Troin <[email protected]> |
| 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) |