git.cworth.org Git - gzip/blob - zmore.1

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