text-utils/more.1

   1 .\" Copyright (c) 1988, 1990 The Regents of the University of California.
   2 .\" Copyright (c) 1988 Mark Nudleman
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. All advertising materials mentioning features or use of this software
  14 .\"    must display the following acknowledgement:
  15 .\"     This product includes software developed by the University of
  16 .\"     California, Berkeley and its contributors.
  17 .\" 4. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     @(#)more.1      5.15 (Berkeley) 7/29/91
  34 .\"
  35 .\" Revised: Fri Dec 25 15:27:27 1992 by root
  36 .\" 25Dec92: Extensive changes made by Rik Faith (faith@cs.unc.edu) to
  37 .\" conform with the more 5.19 currently in use by the Linux community.
  38 .\"
  39 .\" .Dd July 29, 1991 (Modified December 25, 1992)
  40 .Dd December 25, 1992
  41 .Dt MORE 1
  42 .Os "Linux 0.98"
  43 .Sh NAME
  44 .Nm more
  45 .Nd file perusal filter for crt viewing
  46 .Sh SYNOPSIS
  47 .Nm more
  48 .Op Fl dlfpcsu
  49 .Op Fl num
  50 .Op +/\fIpattern\fP
  51 .Op +\fIlinenum\fP
  52 .Op Ar
  53 .Sh DESCRIPTION
  54 .Nm More
  55 is a filter for paging through text one screenful at a time.  This version
  56 is especially primitive.  Users should realize that
  57 .Xr less 1
  58 provides
  59 .Xr more 1
  60 emulation and extensive enhancements.
  61 .Sh OPTIONS
  62 Command line options are described below.
  63 Options are also taken from the environment variable
  64 .Ev MORE
  65 (make sure to precede them with a dash (``-'')) but command
  66 line options will override them.
  67 .Bl -tag -width flag
  68 .It Fl num
  69 This option specifies an integer which is the screen size (in lines).
  70 .It Fl d
  71 .Nm more
  72 will prompt the user with the message "[Press space to continue, 'q' to
  73 quit.]" and will display "[Press 'h' for instructions.]" instead of ringing
  74 the bell when an illegal key is pressed.
  75 .It Fl l
  76 .Nm more
  77 usually treats
  78 .Ic \&^L
  79 (form feed) as a special character, and will pause after any line that
  80 contains a form feed.  The
  81 .Fl l
  82 option will prevent this behavior.
  83 .It Fl f
  84 Causes
  85 .Nm more
  86 to count logical, rather than screen lines (i.e., long lines are not
  87 folded).
  88 .It Fl p
  89 Do not scroll.  Instead, clear the whole screen and then display the text.
  90 .It Fl c
  91 Do not scroll.  Instead, paint each screen from the top, clearing the
  92 remainder of each line as it is displayed.
  93 .It Fl s
  94 Squeeze multiple blank lines into one.
  95 .It Fl u
  96 Suppress underlining.
  97 .It Ic +/
  98 The
  99 .Ic +/
 100 option specifies a string that will be searched for before
 101 each file is displayed.
 102 .It Ic +num
 103 Start at line number
 104 .Ic num .
 105 .El
 106 .Sh COMMANDS
 107 Interactive commands for
 108 .Nm more
 109 are based on
 110 .Xr vi  1  .
 111 Some commands may be preceded by a decimal number, called k in the
 112 descriptions below.
 113 In the following descriptions, ^X means control-X.
 114 .Pp
 115 .Bl -tag -width Ic
 116 .It Ic h No or Ic ?
 117 Help: display a summary of these commands.
 118 If you forget all the other commands, remember this one.
 119 .It Ic SPACE
 120 Display next k lines of text.  Defaults to current screen size.
 121 .It Ic z
 122 Display next k lines of text.  Defaults to current screen size.  Argument
 123 becomes new default.
 124 .It Ic RETURN
 125 Display next k lines of text.  Defaults to 1.  Argument becomes new
 126 default.
 127 .It Ic d No or Ic \&^D
 128 Scroll k lines.  Default is current scroll size, initially 11.  Argument
 129 becomes new default.
 130 .It Xo
 131 .Ic q
 132 .No or
 133 .Ic Q
 134 .No or
 135 .Ic INTERRUPT
 136 .Xc
 137 Exit.
 138 .It Ic s
 139 Skip forward k lines of text.  Defaults to 1.
 140 .It Ic f
 141 Skip forward k screenfuls of text.  Defaults to 1.
 142 .It Ic b No or Ic \&^B
 143 Skip backwards k screenfuls of text.  Defaults to 1.
 144 Only works with files, not pipes.
 145 .It Ic '
 146 Go to place where previous search started.
 147 .It Ic =
 148 Display current line number.
 149 .It Ic \&/ Ns Ar pattern
 150 Search for kth occurrence of regular expression.  Defaults to 1.
 151 .It Ic n
 152 Search for kth occurrence of last r.e.  Defaults to 1.
 153 .It Ic !<cmd> No or Ic :!<cmd>
 154 Execute <cmd> in a subshell
 155 .It Ic v
 156 Start up an editor at current line.
 157 The editor is taken from the environment variable VISUAL if defined,
 158 or EDITOR if VISUAL is not defined,
 159 or defaults to "vi" if neither VISUAL nor EDITOR is defined.
 160 .It Ic \&^L
 161 Redraw screen
 162 .It Ic :n
 163 Go to kth next file.  Defaults to 1.
 164 .It Ic :p
 165 Go to kth previous file.  Defaults to 1.
 166 .It Ic :f
 167 Display current file name and line number
 168 .It Ic \&.
 169 Repeat previous command
 170 .El
 171 .Sh ENVIRONMENT
 172 .Nm More
 173 utilizes the following environment variables, if they exist:
 174 .Bl -tag -width Fl
 175 .It Ev MORE
 176 This variable may be set with favored options to
 177 .Nm more .
 178 .It Ev SHELL
 179 Current shell in use (normally set by the shell at login time).
 180 .It Ev TERM
 181 Specifies terminal type, used by more to get the terminal
 182 characteristics necessary to manipulate the screen.
 183 .El
 184 .Sh SEE ALSO
 185 .Xr vi 1 ,
 186 .Xr less 1
 187 .Sh AUTHORS
 188 Eric Shienbrood, UC Berkeley
 189 .br
 190 Modified by Geoff Peck, UCB to add underlining, single spacing
 191 .br
 192 Modified by John Foderaro, UCB to add -c and MORE environment variable
 193 .Sh HISTORY
 194 The
 195 .Nm more
 196 command appeared in
 197 .Bx 3.0 .
 198 This man page documents
 199 .Nm more
 200 version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux
 201 community.  Documentation was produced using several other versions of the
 202 man page, and extensive inspection of the source code.
 203 .Sh AVAILABILITY
 204 The more command is part of the util-linux-ng package and is available from
 205 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.