components/bzip2/manpages/bzmore.1

   1 .\"
   2 .\"Shamelessly copied from zmore.1 by Philippe Troin <phil@fifi.org>
   3 .\"for Debian GNU/Linux
   4 .TH BZMORE 1
   5 .SH NAME
   6 bzmore, bzless \- file perusal filter for crt viewing of bzip2 compressed text
   7 .SH SYNOPSIS
   8 .B bzmore
   9 [ name ...  ]
  10 .br
  11 .B bzless
  12 [ name ...  ]
  13 .SH NOTE
  14 In the following description,
  15 .I bzless
  16 and
  17 .I less
  18 can be used interchangeably with
  19 .I bzmore
  20 and
  21 .I more.
  22 .SH DESCRIPTION
  23 .I  Bzmore
  24 is a filter which allows examination of compressed or plain text files
  25 one screenful at a time on a soft-copy terminal.
  26 .I bzmore
  27 works on files compressed with
  28 .I bzip2
  29 and also on uncompressed files.
  30 If a file does not exist,
  31 .I bzmore
  32 looks for a file of the same name with the addition of a .bz2 suffix.
  33 .PP
  34 .I Bzmore
  35 normally pauses after each screenful, printing --More--
  36 at the bottom of the screen.
  37 If the user then types a carriage return, one more line is displayed.
  38 If the user hits a space,
  39 another screenful is displayed.  Other possibilities are enumerated later.
  40 .PP
  41 .I Bzmore
  42 looks in the file
  43 .I /etc/termcap
  44 to determine terminal characteristics,
  45 and to determine the default window size.
  46 On a terminal capable of displaying 24 lines,
  47 the default window size is 22 lines.
  48 Other sequences which may be typed when
  49 .I bzmore
  50 pauses, and their effects, are as follows (\fIi\fP is an optional integer
  51 argument, defaulting to 1) :
  52 .PP
  53 .IP \fIi\|\fP<space>
  54 display
  55 .I i
  56 more lines, (or another screenful if no argument is given)
  57 .PP
  58 .IP ^D
  59 display 11 more lines (a ``scroll'').
  60 If
  61 .I i
  62 is given, then the scroll size is set to \fIi\|\fP.
  63 .PP
  64 .IP d
  65 same as ^D (control-D)
  66 .PP
  67 .IP \fIi\|\fPz
  68 same as typing a space except that \fIi\|\fP, if present, becomes the new
  69 window size.  Note that the window size reverts back to the default at the
  70 end of the current file.
  71 .PP
  72 .IP \fIi\|\fPs
  73 skip \fIi\|\fP lines and print a screenful of lines
  74 .PP
  75 .IP \fIi\|\fPf
  76 skip \fIi\fP screenfuls and print a screenful of lines
  77 .PP
  78 .IP "q or Q"
  79 quit reading the current file; go on to the next (if any)
  80 .PP
  81 .IP "e or q"
  82 When the prompt --More--(Next file:
  83 .IR file )
  84 is printed, this command causes bzmore to exit.
  85 .PP
  86 .IP s
  87 When the prompt --More--(Next file:
  88 .IR file )
  89 is printed, this command causes bzmore to skip the next file and continue.
  90 .PP
  91 .IP =
  92 Display the current line number.
  93 .PP
  94 .IP \fIi\|\fP/expr
  95 search for the \fIi\|\fP-th occurrence of the regular expression \fIexpr.\fP
  96 If the pattern is not found,
  97 .I bzmore
  98 goes on to the next file (if any).
  99 Otherwise, a screenful is displayed, starting two lines before the place
 100 where the expression was found.
 101 The user's erase and kill characters may be used to edit the regular
 102 expression.
 103 Erasing back past the first column cancels the search command.
 104 .PP
 105 .IP \fIi\|\fPn
 106 search for the \fIi\|\fP-th occurrence of the last regular expression entered.
 107 .PP
 108 .IP !command
 109 invoke a shell with \fIcommand\|\fP.
 110 The character `!' in "command" are replaced with the
 111 previous shell command.  The sequence "\\!" is replaced by "!".
 112 .PP
 113 .IP ":q or :Q"
 114 quit reading the current file; go on to the next (if any)
 115 (same as q or Q).
 116 .PP
 117 .IP .
 118 (dot) repeat the previous command.
 119 .PP
 120 The commands take effect immediately, i.e., it is not necessary to
 121 type a carriage return.
 122 Up to the time when the command character itself is given,
 123 the user may hit the line kill character to cancel the numerical
 124 argument being formed.
 125 In addition, the user may hit the erase character to redisplay the
 126 --More-- message.
 127 .PP
 128 At any time when output is being sent to the terminal, the user can
 129 hit the quit key (normally control\-\\).
 130 .I Bzmore
 131 will stop sending output, and will display the usual --More--
 132 prompt.
 133 The user may then enter one of the above commands in the normal manner.
 134 Unfortunately, some output is lost when this is done, due to the
 135 fact that any characters waiting in the terminal's output queue
 136 are flushed when the quit signal occurs.
 137 .PP
 138 The terminal is set to
 139 .I noecho
 140 mode by this program so that the output can be continuous.
 141 What you type will thus not show on your terminal, except for the / and !
 142 commands.
 143 .PP
 144 If the standard output is not a teletype, then
 145 .I bzmore
 146 acts just like
 147 .I bzcat,
 148 except that a header is printed before each file.
 149 .SH FILES
 150 .DT
 151 /etc/termcap            Terminal data base
 152 .SH "SEE ALSO"
 153 more(1), less(1), bzip2(1), bzdiff(1), bzgrep(1)