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 .\" Copyright (c) 1992 Rik Faith (faith@cs.unc.edu)
  36 .\"
  37 .TH MORE "1" "March 2020" "util-linux" "User Commands"
  38 .SH NAME
  39 more \- file perusal filter for crt viewing
  40 .SH SYNOPSIS
  41 .B more
  42 [options]
  43 .IR file ...
  44 .SH DESCRIPTION
  45 .B more
  46 is a filter for paging through text one screenful at a time.  This version is
  47 especially primitive.  Users should realize that
  48 .BR less (1)
  49 provides
  50 .BR more (1)
  51 emulation plus extensive enhancements.
  52 .SH OPTIONS
  53 Options are also taken from the environment variable
  54 .B MORE
  55 (make sure to precede them with a dash
  56 .RB ( \- ))
  57 but command-line options will override those.
  58 .TP
  59 .BR \-d , " \-\-silent"
  60 Prompt with "[Press space to continue, 'q' to quit.]",
  61 and display "[Press 'h' for instructions.]" instead of ringing
  62 the bell when an illegal key is pressed.
  63 .TP
  64 .BR \-l , " \-\-logical"
  65 Do not pause after any line containing a
  66 .B \&^L
  67 (form feed).
  68 .TP
  69 .BR \-f , " \-\-no\-pause"
  70 Count logical lines, rather than screen lines (i.e., long lines are not folded).
  71 .TP
  72 .BR \-p , " \-\-print\-over"
  73 Do not scroll.  Instead, clear the whole screen and then display the text.
  74 Notice that this option is switched on automatically if the executable is
  75 named
  76 .BR page .
  77 .TP
  78 .BR \-c , " \-\-clean\-print"
  79 Do not scroll.  Instead, paint each screen from the top, clearing the
  80 remainder of each line as it is displayed.
  81 .TP
  82 .BR \-s , " \-\-squeeze"
  83 Squeeze multiple blank lines into one.
  84 .TP
  85 .BR \-u , " \-\-plain"
  86 Suppress underlining.  This option is silently ignored as backwards
  87 compatibility.
  88 .TP
  89 \fB\-n\fR, \fB\-\-lines \fInumber\fR
  90 Specify the
  91 .I number
  92 of lines per screenful.  The
  93 .I number
  94 argument is a positive decimal integer.  The
  95 .B \-\-lines
  96 option shall override any values obtained from any other source, such as
  97 number of lines reported by terminal.
  98 .TP
  99 .BI \- number
 100 A numeric option means the same as
 101 .B \-\-lines
 102 option argument.
 103 .TP
 104 .BI + number
 105 Start displaying each file at line
 106 .IR number .
 107 .TP
 108 .BI +/ string
 109 The
 110 .I string
 111 to be searched in each file before starting to display it.
 112 .TP
 113 \fB\-\-help\fR
 114 Display help text and exit.
 115 .TP
 116 \fB\-V\fR, \fB\-\-version\fR
 117 Display version information and exit.
 118 .SH COMMANDS
 119 Interactive commands for
 120 .B more
 121 are based on
 122 .BR vi (1).
 123 Some commands may be preceded by a decimal number, called k in the
 124 descriptions below.  In the following descriptions,
 125 .B ^X
 126 means
 127 .BR control-X .
 128 .PP
 129 .RS
 130 .PD 1
 131 .TP 10
 132 .BR h \ or \ ?
 133 Help; display a summary of these commands.  If you forget all other
 134 commands, remember this one.
 135 .TP
 136 .B SPACE
 137 Display next k lines of text.  Defaults to current screen size.
 138 .TP
 139 .B z
 140 Display next k lines of text.  Defaults to current screen size.  Argument
 141 becomes new default.
 142 .TP
 143 .B RETURN
 144 Display next k lines of text.  Defaults to 1.  Argument becomes new default.
 145 .TP
 146 .BR d \ or \ \&^D
 147 Scroll k lines.  Default is current scroll size, initially 11.  Argument
 148 becomes new default.
 149 .TP
 150 .BR q \ or \ Q \ or \ INTERRUPT
 151 Exit.
 152 .TP
 153 .B s
 154 Skip forward k lines of text.  Defaults to 1.
 155 .TP
 156 .B f
 157 Skip forward k screenfuls of text.  Defaults to 1.
 158 .TP
 159 .BR b \ or \ \&^B
 160 Skip backwards k screenfuls of text.  Defaults to 1.  Only works with files,
 161 not pipes.
 162 .TP
 163 .B '
 164 Go to the place where the last search started.
 165 .TP
 166 .B =
 167 Display current line number.
 168 .TP
 169 .B \&/pattern
 170 Search for kth occurrence of regular expression.  Defaults to 1.
 171 .TP
 172 .B n
 173 Search for kth occurrence of last regular expression.  Defaults to 1.
 174 .TP
 175 .BR !command \ or \ :!command
 176 Execute
 177 .I command
 178 in a subshell.
 179 .TP
 180 .B v
 181 Start up an editor at current line.  The editor is taken from the environment
 182 variable
 183 .B VISUAL
 184 if defined, or
 185 .B EDITOR
 186 if
 187 .B VISUAL
 188 is not defined, or defaults
 189 to
 190 .B vi
 191 if neither
 192 .B VISUAL
 193 nor
 194 .B EDITOR
 195 is defined.
 196 .TP
 197 .B \&^L
 198 Redraw screen.
 199 .TP
 200 .B :n
 201 Go to kth next file.  Defaults to 1.
 202 .TP
 203 .B :p
 204 Go to kth previous file.  Defaults to 1.
 205 .TP
 206 .B :f
 207 Display current file name and line number.
 208 .TP
 209 .B \&.
 210 Repeat previous command.
 211 .RE
 212 .SH ENVIRONMENT
 213 The
 214 .B more
 215 command respects the following environment variables, if they exist:
 216 .TP
 217 .B MORE
 218 This variable may be set with favored options to
 219 .BR more .
 220 .TP
 221 .B SHELL
 222 Current shell in use (normally set by the shell at login time).
 223 .TP
 224 .B TERM
 225 The terminal type used by \fBmore\fR to get the terminal
 226 characteristics necessary to manipulate the screen.
 227 .TP
 228 .B VISUAL
 229 The editor the user prefers.  Invoked when command key
 230 .I v
 231 is pressed.
 232 .TP
 233 .B EDITOR
 234 The editor of choice when
 235 .B VISUAL
 236 is not specified.
 237 .SH HISTORY
 238 The
 239 .B more
 240 command appeared in 3.0BSD.  This man page documents
 241 .B more
 242 version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux
 243 community.  Documentation was produced using several other versions of the
 244 man page, and extensive inspection of the source code.
 245 .SH AUTHORS
 246 Eric Shienbrood, UC Berkeley
 247 .br
 248 Modified by Geoff Peck, UCB to add underlining, single spacing
 249 .br
 250 Modified by John Foderaro, UCB to add \-c and MORE environment variable
 251 .SH SEE ALSO
 252 .BR less (1),
 253 .BR vi (1)
 254 .SH AVAILABILITY
 255 The more command is part of the util-linux package and is available from
 256 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 257 Linux Kernel Archive
 258 .UE .