The Android Open Source Project | cfb3b27 | 2009-03-03 19:29:20 -0800 | [diff] [blame] | 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) |