]> git.ipfire.org Git - thirdparty/util-linux.git/blob - text-utils/more.1
su: use lib/pty-session.c code for --pty
[thirdparty/util-linux.git] / 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 .