external/bsd/bzip2/dist/bzmore.1

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