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