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" "February 2014" "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 .B \-d
  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 .B \-l
  65 Do not pause after any line containing a
  66 .B \&^L
  67 (form feed).
  68 .TP
  69 .B \-f
  70 Count logical lines, rather than screen lines (i.e., long lines are not folded).
  71 .TP
  72 .B \-p
  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 .B \-c
  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 .B \-s
  83 Squeeze multiple blank lines into one.
  84 .TP
  85 .B \-u
  86 Suppress underlining.
  87 .TP
  88 .BI \- number
  89 The screen size to use, in
  90 .I number
  91 of lines.
  92 .TP
  93 .BI + number
  94 Start displaying each file at line
  95 .IR number .
  96 .TP
  97 .BI +/ string
  98 The
  99 .I string
 100 to be searched in each file before starting to display it.
 101 .TP
 102 \fB\-\-help\fR
 103 Display help text and exit.
 104 .TP
 105 \fB\-V\fR, \fB\-\-version\fR
 106 Display version information and exit.
 107 .SH COMMANDS
 108 Interactive commands for
 109 .B more
 110 are based on
 111 .BR vi (1).
 112 Some commands may be preceded by a decimal number, called k in the
 113 descriptions below.  In the following descriptions,
 114 .B ^X
 115 means
 116 .BR control-X .
 117 .PP
 118 .RS
 119 .PD 1
 120 .TP 10
 121 .BR h \ or \ ?
 122 Help; display a summary of these commands.  If you forget all other
 123 commands, remember this one.
 124 .TP
 125 .B SPACE
 126 Display next k lines of text.  Defaults to current screen size.
 127 .TP
 128 .B z
 129 Display next k lines of text.  Defaults to current screen size.  Argument
 130 becomes new default.
 131 .TP
 132 .B RETURN
 133 Display next k lines of text.  Defaults to 1.  Argument becomes new default.
 134 .TP
 135 .BR d \ or \ \&^D
 136 Scroll k lines.  Default is current scroll size, initially 11.  Argument
 137 becomes new default.
 138 .TP
 139 .BR q \ or \ Q \ or \ INTERRUPT
 140 Exit.
 141 .TP
 142 .B s
 143 Skip forward k lines of text.  Defaults to 1.
 144 .TP
 145 .B f
 146 Skip forward k screenfuls of text.  Defaults to 1.
 147 .TP
 148 .BR b \ or \ \&^B
 149 Skip backwards k screenfuls of text.  Defaults to 1.  Only works with files,
 150 not pipes.
 151 .TP
 152 .B '
 153 Go to the place where the last search started.
 154 .TP
 155 .B =
 156 Display current line number.
 157 .TP
 158 .B \&/pattern
 159 Search for kth occurrence of regular expression.  Defaults to 1.
 160 .TP
 161 .B n
 162 Search for kth occurrence of last regular expression.  Defaults to 1.
 163 .TP
 164 .BR !command \ or \ :!command
 165 Execute
 166 .I command
 167 in a subshell.
 168 .TP
 169 .B v
 170 Start up an editor at current line.  The editor is taken from the environment
 171 variable
 172 .B VISUAL
 173 if defined, or
 174 .B EDITOR
 175 if
 176 .B VISUAL
 177 is not defined, or defaults
 178 to
 179 .B vi
 180 if neither
 181 .B VISUAL
 182 nor
 183 .B EDITOR
 184 is defined.
 185 .TP
 186 .B \&^L
 187 Redraw screen.
 188 .TP
 189 .B :n
 190 Go to kth next file.  Defaults to 1.
 191 .TP
 192 .B :p
 193 Go to kth previous file.  Defaults to 1.
 194 .TP
 195 .B :f
 196 Display current file name and line number.
 197 .TP
 198 .B \&.
 199 Repeat previous command.
 200 .SH ENVIRONMENT
 201 The
 202 .B more
 203 command respects the following environment variables, if they exist:
 204 .TP
 205 .B MORE
 206 This variable may be set with favored options to
 207 .BR more .
 208 .TP
 209 .B SHELL
 210 Current shell in use (normally set by the shell at login time).
 211 .TP
 212 .B TERM
 213 The terminal type used by \fBmore\fR to get the terminal
 214 characteristics necessary to manipulate the screen.
 215 .TP
 216 .B VISUAL
 217 The editor the user prefers.  Invoked when command key
 218 .I v
 219 is pressed.
 220 .TP
 221 .B EDITOR
 222 The editor of choice when
 223 .B VISUAL
 224 is not specified.
 225 .SH SEE ALSO
 226 .BR less (1),
 227 .BR vi (1)
 228 .SH AUTHORS
 229 Eric Shienbrood, UC Berkeley
 230 .br
 231 Modified by Geoff Peck, UCB to add underlining, single spacing
 232 .br
 233 Modified by John Foderaro, UCB to add -c and MORE environment variable
 234 .SH HISTORY
 235 The
 236 .B more
 237 command appeared in 3.0BSD.  This man page documents
 238 .B more
 239 version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux
 240 community.  Documentation was produced using several other versions of the
 241 man page, and extensive inspection of the source code.
 242 .SH AVAILABILITY
 243 The more command is part of the util-linux package and is available from
 244 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 245 Linux Kernel Archive
 246 .UE .