← Back to branch summary

~baltix/+junk/irrlicht-test

« back to all changes in this revision

Viewing changes to source/Irrlicht/bzip2/bzmore.1

  • Committer: Mantas Kriaučiūnas
  • Date: 2011-07-18 13:06:25 UTC
  • Revision ID: mantas@akl.lt-20110718130625-c5pvifp61e7kj1ol
Included whole irrlicht SVN libraries to work around launchpad recipe issue with quilt, see https://answers.launchpad.net/launchpad/+question/165193

Show diffs side-by-side

added added

removed removed

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