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