| [9] | 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)
|
|---|
