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