cannam@89: .\"Shamelessly copied from zmore.1 by Philippe Troin cannam@89: .\"for Debian GNU/Linux cannam@89: .TH BZMORE 1 cannam@89: .SH NAME cannam@89: bzmore, bzless \- file perusal filter for crt viewing of bzip2 compressed text cannam@89: .SH SYNOPSIS cannam@89: .B bzmore cannam@89: [ name ... ] cannam@89: .br cannam@89: .B bzless cannam@89: [ name ... ] cannam@89: .SH NOTE cannam@89: In the following description, cannam@89: .I bzless cannam@89: and cannam@89: .I less cannam@89: can be used interchangeably with cannam@89: .I bzmore cannam@89: and cannam@89: .I more. cannam@89: .SH DESCRIPTION cannam@89: .I Bzmore cannam@89: is a filter which allows examination of compressed or plain text files cannam@89: one screenful at a time on a soft-copy terminal. cannam@89: .I bzmore cannam@89: works on files compressed with cannam@89: .I bzip2 cannam@89: and also on uncompressed files. cannam@89: If a file does not exist, cannam@89: .I bzmore cannam@89: looks for a file of the same name with the addition of a .bz2 suffix. cannam@89: .PP cannam@89: .I Bzmore cannam@89: normally pauses after each screenful, printing --More-- cannam@89: at the bottom of the screen. cannam@89: If the user then types a carriage return, one more line is displayed. cannam@89: If the user hits a space, cannam@89: another screenful is displayed. Other possibilities are enumerated later. cannam@89: .PP cannam@89: .I Bzmore cannam@89: looks in the file cannam@89: .I /etc/termcap cannam@89: to determine terminal characteristics, cannam@89: and to determine the default window size. cannam@89: On a terminal capable of displaying 24 lines, cannam@89: the default window size is 22 lines. cannam@89: Other sequences which may be typed when cannam@89: .I bzmore cannam@89: pauses, and their effects, are as follows (\fIi\fP is an optional integer cannam@89: argument, defaulting to 1) : cannam@89: .PP cannam@89: .IP \fIi\|\fP cannam@89: display cannam@89: .I i cannam@89: more lines, (or another screenful if no argument is given) cannam@89: .PP cannam@89: .IP ^D cannam@89: display 11 more lines (a ``scroll''). cannam@89: If cannam@89: .I i cannam@89: is given, then the scroll size is set to \fIi\|\fP. cannam@89: .PP cannam@89: .IP d cannam@89: same as ^D (control-D) cannam@89: .PP cannam@89: .IP \fIi\|\fPz cannam@89: same as typing a space except that \fIi\|\fP, if present, becomes the new cannam@89: window size. Note that the window size reverts back to the default at the cannam@89: end of the current file. cannam@89: .PP cannam@89: .IP \fIi\|\fPs cannam@89: skip \fIi\|\fP lines and print a screenful of lines cannam@89: .PP cannam@89: .IP \fIi\|\fPf cannam@89: skip \fIi\fP screenfuls and print a screenful of lines cannam@89: .PP cannam@89: .IP "q or Q" cannam@89: quit reading the current file; go on to the next (if any) cannam@89: .PP cannam@89: .IP "e or q" cannam@89: When the prompt --More--(Next file: cannam@89: .IR file ) cannam@89: is printed, this command causes bzmore to exit. cannam@89: .PP cannam@89: .IP s cannam@89: When the prompt --More--(Next file: cannam@89: .IR file ) cannam@89: is printed, this command causes bzmore to skip the next file and continue. cannam@89: .PP cannam@89: .IP = cannam@89: Display the current line number. cannam@89: .PP cannam@89: .IP \fIi\|\fP/expr cannam@89: search for the \fIi\|\fP-th occurrence of the regular expression \fIexpr.\fP cannam@89: If the pattern is not found, cannam@89: .I bzmore cannam@89: goes on to the next file (if any). cannam@89: Otherwise, a screenful is displayed, starting two lines before the place cannam@89: where the expression was found. cannam@89: The user's erase and kill characters may be used to edit the regular cannam@89: expression. cannam@89: Erasing back past the first column cancels the search command. cannam@89: .PP cannam@89: .IP \fIi\|\fPn cannam@89: search for the \fIi\|\fP-th occurrence of the last regular expression entered. cannam@89: .PP cannam@89: .IP !command cannam@89: invoke a shell with \fIcommand\|\fP. cannam@89: The character `!' in "command" are replaced with the cannam@89: previous shell command. The sequence "\\!" is replaced by "!". cannam@89: .PP cannam@89: .IP ":q or :Q" cannam@89: quit reading the current file; go on to the next (if any) cannam@89: (same as q or Q). cannam@89: .PP cannam@89: .IP . cannam@89: (dot) repeat the previous command. cannam@89: .PP cannam@89: The commands take effect immediately, i.e., it is not necessary to cannam@89: type a carriage return. cannam@89: Up to the time when the command character itself is given, cannam@89: the user may hit the line kill character to cancel the numerical cannam@89: argument being formed. cannam@89: In addition, the user may hit the erase character to redisplay the cannam@89: --More-- message. cannam@89: .PP cannam@89: At any time when output is being sent to the terminal, the user can cannam@89: hit the quit key (normally control\-\\). cannam@89: .I Bzmore cannam@89: will stop sending output, and will display the usual --More-- cannam@89: prompt. cannam@89: The user may then enter one of the above commands in the normal manner. cannam@89: Unfortunately, some output is lost when this is done, due to the cannam@89: fact that any characters waiting in the terminal's output queue cannam@89: are flushed when the quit signal occurs. cannam@89: .PP cannam@89: The terminal is set to cannam@89: .I noecho cannam@89: mode by this program so that the output can be continuous. cannam@89: What you type will thus not show on your terminal, except for the / and ! cannam@89: commands. cannam@89: .PP cannam@89: If the standard output is not a teletype, then cannam@89: .I bzmore cannam@89: acts just like cannam@89: .I bzcat, cannam@89: except that a header is printed before each file. cannam@89: .SH FILES cannam@89: .DT cannam@89: /etc/termcap Terminal data base cannam@89: .SH "SEE ALSO" cannam@89: more(1), less(1), bzip2(1), bzdiff(1), bzgrep(1)