PageRenderTime 335ms CodeModel.GetById 2ms app.highlight 2ms RepoModel.GetById 0ms app.codeStats 1ms

/StormLib/stormlib/bzip2/bzmore.1

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