Mercurial > hg > sv-dependency-builds

annotate src/bzip2-1.0.6/bzmore.1 @ 169:223a55898ab9 tip default

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