manual/util-linux/original/man1/more.1

   1 '\" t
   2 .\"     Title: more
   3 .\"    Author: [see the "AUTHOR(S)" section]
   4 .\" Generator: Asciidoctor 2.0.15
   5 .\"      Date: 2021-06-02
   6 .\"    Manual: User Commands
   7 .\"    Source: util-linux 2.37.2
   8 .\"  Language: English
   9 .\"
  10 .TH "MORE" "1" "2021-06-02" "util\-linux 2.37.2" "User Commands"
  11 .ie \n(.g .ds Aq \(aq
  12 .el       .ds Aq '
  13 .ss \n[.ss] 0
  14 .nh
  15 .ad l
  16 .de URL
  17 \fI\\$2\fP <\\$1>\\$3
  18 ..
  19 .als MTO URL
  20 .if \n[.g] \{\
  21 .  mso www.tmac
  22 .  am URL
  23 .    ad l
  24 .  .
  25 .  am MTO
  26 .    ad l
  27 .  .
  28 .  LINKSTYLE blue R < >
  29 .\}
  30 .SH "NAME"
  31 more \- file perusal filter for crt viewing
  32 .SH "SYNOPSIS"
  33 .sp
  34 \fBmore\fP [options] \fIfile\fP ...
  35 .SH "DESCRIPTION"
  36 .sp
  37 \fBmore\fP is a filter for paging through text one screenful at a time. This version is especially primitive. Users should realize that \fBless\fP(1) provides \fBmore\fP(1) emulation plus extensive enhancements.
  38 .SH "OPTIONS"
  39 .sp
  40 Options are also taken from the environment variable \fBMORE\fP (make sure to precede them with a dash (\fB\-\fP)) but command\-line options will override those.
  41 .sp
  42 \fB\-d\fP, \fB\-\-silent\fP
  43 .RS 4
  44 Prompt with "[Press space to continue, \(aqq\(aq to quit.]", and display "[Press \(aqh\(aq for instructions.]" instead of ringing the bell when an illegal key is pressed.
  45 .RE
  46 .sp
  47 \fB\-l\fP, \fB\-\-logical\fP
  48 .RS 4
  49 Do not pause after any line containing a \fB^L\fP (form feed).
  50 .RE
  51 .sp
  52 \fB\-f\fP, \fB\-\-no\-pause\fP
  53 .RS 4
  54 Count logical lines, rather than screen lines (i.e., long lines are not folded).
  55 .RE
  56 .sp
  57 \fB\-p\fP, \fB\-\-print\-over\fP
  58 .RS 4
  59 Do not scroll. Instead, clear the whole screen and then display the text. Notice that this option is switched on automatically if the executable is named \fBpage\fP.
  60 .RE
  61 .sp
  62 \fB\-c\fP, \fB\-\-clean\-print\fP
  63 .RS 4
  64 Do not scroll. Instead, paint each screen from the top, clearing the remainder of each line as it is displayed.
  65 .RE
  66 .sp
  67 \fB\-s\fP, \fB\-\-squeeze\fP
  68 .RS 4
  69 Squeeze multiple blank lines into one.
  70 .RE
  71 .sp
  72 \fB\-u\fP, \fB\-\-plain\fP
  73 .RS 4
  74 Suppress underlining. This option is silently ignored as backwards compatibility.
  75 .RE
  76 .sp
  77 \fB\-n\fP, \fB\-\-lines\fP \fInumber\fP
  78 .RS 4
  79 Specify the \fInumber\fP of lines per screenful. The \fInumber\fP argument is a positive decimal integer. The \fB\-\-lines\fP option shall override any values obtained from any other source, such as number of lines reported by terminal.
  80 .RE
  81 .sp
  82 \fB\-\fP\fInumber\fP
  83 .RS 4
  84 A numeric option means the same as \fB\-\-lines\fP option argument.
  85 .RE
  86 .sp
  87 \fB+\fP\fInumber\fP
  88 .RS 4
  89 Start displaying each file at line \fInumber\fP.
  90 .RE
  91 .sp
  92 \fB+\fP/\fIstring\fP
  93 .RS 4
  94 The \fIstring\fP to be searched in each file before starting to display it.
  95 .RE
  96 .sp
  97 \fB\-\-help\fP
  98 .RS 4
  99 Display help text and exit.
 100 .RE
 101 .sp
 102 \fB\-V\fP, \fB\-\-version\fP
 103 .RS 4
 104 Display version information and exit.
 105 .RE
 106 .SH "COMMANDS"
 107 .sp
 108 Interactive commands for \fBmore\fP are based on \fBvi\fP(1). Some commands may be preceded by a decimal number, called k in the descriptions below. In the following descriptions, \fB^X\fP means \fBcontrol\-X\fP.
 109 .sp
 110 \fBh\fP or \fB?\fP
 111 .RS 4
 112 Help; display a summary of these commands. If you forget all other commands, remember this one.
 113 .RE
 114 .sp
 115 \fBSPACE\fP
 116 .RS 4
 117 Display next k lines of text. Defaults to current screen size.
 118 .RE
 119 .sp
 120 \fBz\fP
 121 .RS 4
 122 Display next k lines of text. Defaults to current screen size. Argument becomes new default.
 123 .RE
 124 .sp
 125 \fBRETURN\fP
 126 .RS 4
 127 Display next k lines of text. Defaults to 1. Argument becomes new default.
 128 .RE
 129 .sp
 130 \fBd\fP or \fB^D\fP
 131 .RS 4
 132 Scroll k lines. Default is current scroll size, initially 11. Argument becomes new default.
 133 .RE
 134 .sp
 135 \fBq\fP or \fBQ\fP or \fBINTERRUPT\fP
 136 .RS 4
 137 Exit.
 138 .RE
 139 .sp
 140 \fBs\fP
 141 .RS 4
 142 Skip forward k lines of text. Defaults to 1.
 143 .RE
 144 .sp
 145 \fBf\fP
 146 .RS 4
 147 Skip forward k screenfuls of text. Defaults to 1.
 148 .RE
 149 .sp
 150 \fBb\fP or \fB^B\fP
 151 .RS 4
 152 Skip backwards k screenfuls of text. Defaults to 1. Only works with files, not pipes.
 153 .RE
 154 .sp
 155 \fB\(aq\fP
 156 .RS 4
 157 Go to the place where the last search started.
 158 .RE
 159 .sp
 160 \fB=\fP
 161 .RS 4
 162 Display current line number.
 163 .RE
 164 .sp
 165 \fB/pattern\fP
 166 .RS 4
 167 Search for kth occurrence of regular expression. Defaults to 1.
 168 .RE
 169 .sp
 170 \fBn\fP
 171 .RS 4
 172 Search for kth occurrence of last regular expression. Defaults to 1.
 173 .RE
 174 .sp
 175 \fB!command\fP or \fB:!command\fP
 176 .RS 4
 177 Execute \fIcommand\fP in a subshell.
 178 .RE
 179 .sp
 180 \fBv\fP
 181 .RS 4
 182 Start up an editor at current line. The editor is taken from the environment variable \fBVISUAL\fP if defined, or \fBEDITOR\fP if \fBVISUAL\fP is not defined, or defaults to \fBvi\fP(1) if neither \fBVISUAL\fP nor \fBEDITOR\fP is defined.
 183 .RE
 184 .sp
 185 \fB^L\fP
 186 .RS 4
 187 Redraw screen.
 188 .RE
 189 .sp
 190 \fB:n\fP
 191 .RS 4
 192 Go to kth next file. Defaults to 1.
 193 .RE
 194 .sp
 195 \fB:p\fP
 196 .RS 4
 197 Go to kth previous file. Defaults to 1.
 198 .RE
 199 .sp
 200 \fB:f\fP
 201 .RS 4
 202 Display current file name and line number.
 203 .RE
 204 .sp
 205 \fB.\fP
 206 .RS 4
 207 Repeat previous command.
 208 .RE
 209 .SH "ENVIRONMENT"
 210 .sp
 211 The \fBmore\fP command respects the following environment variables, if they exist:
 212 .sp
 213 \fBMORE\fP
 214 .RS 4
 215 This variable may be set with favored options to \fBmore\fP.
 216 .RE
 217 .sp
 218 \fBSHELL\fP
 219 .RS 4
 220 Current shell in use (normally set by the shell at login time).
 221 .RE
 222 .sp
 223 \fBTERM\fP
 224 .RS 4
 225 The terminal type used by \fBmore\fP to get the terminal characteristics necessary to manipulate the screen.
 226 .RE
 227 .sp
 228 \fBVISUAL\fP
 229 .RS 4
 230 The editor the user prefers. Invoked when command key \fIv\fP is pressed.
 231 .RE
 232 .sp
 233 \fBEDITOR\fP
 234 .RS 4
 235 The editor of choice when \fBVISUAL\fP is not specified.
 236 .RE
 237 .SH "HISTORY"
 238 .sp
 239 The \fBmore\fP command appeared in 3.0BSD. This man page documents \fBmore\fP version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux community. Documentation was produced using several other versions of the man page, and extensive inspection of the source code.
 240 .SH "AUTHORS"
 241 .sp
 242 Eric Shienbrood, UC Berkeley.
 243 .sp
 244 Modified by Geoff Peck, UCB to add underlining, single spacing.
 245 .sp
 246 Modified by John Foderaro, UCB to add \-c and MORE environment variable.
 247 .SH "SEE ALSO"
 248 .sp
 249 \fBless\fP(1),
 250 \fBvi\fP(1)
 251 .SH "REPORTING BUGS"
 252 .sp
 253 For bug reports, use the issue tracker at \c
 254 .URL "https://github.com/karelzak/util\-linux/issues" "" "."
 255 .SH "AVAILABILITY"
 256 .sp
 257 The \fBmore\fP command is part of the util\-linux package which can be downloaded from \c
 258 .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."