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