]>
Commit | Line | Data |
---|---|---|
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 |
39 | more \- 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 | |
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) | |
6dbe3af9 | 49 | provides |
f4ddf6ff | 50 | .BR more (1) |
5bcd986e | 51 | emulation plus extensive enhancements. |
f4ddf6ff | 52 | .SH OPTIONS |
01cc21f5 | 53 | Options are also taken from the environment variable |
f4ddf6ff | 54 | .B MORE |
01cc21f5 BS |
55 | (make sure to precede them with a dash |
56 | .RB ( \- )) | |
57 | but command-line options will override those. | |
f4ddf6ff | 58 | .TP |
f4ddf6ff | 59 | .B \-d |
01cc21f5 BS |
60 | Prompt with "[Press space to continue, 'q' to quit.]", |
61 | and display "[Press 'h' for instructions.]" instead of ringing | |
6dbe3af9 | 62 | the bell when an illegal key is pressed. |
f4ddf6ff SK |
63 | .TP |
64 | .B \-l | |
01cc21f5 | 65 | Do not pause after any line containing a |
f4ddf6ff | 66 | .B \&^L |
01cc21f5 | 67 | (form feed). |
f4ddf6ff | 68 | .TP |
01cc21f5 BS |
69 | .B \-f |
70 | Count logical lines, rather than screen lines (i.e., long lines are not folded). | |
f4ddf6ff SK |
71 | .TP |
72 | .B \-p | |
6dbe3af9 | 73 | Do not scroll. Instead, clear the whole screen and then display the text. |
f4ddf6ff SK |
74 | Notice that this option is switched on automatically if the executable is |
75 | named | |
76 | .BR page . | |
77 | .TP | |
78 | .B \-c | |
6dbe3af9 KZ |
79 | Do not scroll. Instead, paint each screen from the top, clearing the |
80 | remainder of each line as it is displayed. | |
f4ddf6ff SK |
81 | .TP |
82 | .B \-s | |
6dbe3af9 | 83 | Squeeze multiple blank lines into one. |
f4ddf6ff SK |
84 | .TP |
85 | .B \-u | |
6dbe3af9 | 86 | Suppress underlining. |
f4ddf6ff | 87 | .TP |
4c5a6f3d BS |
88 | .BI \- number |
89 | The screen size to use, in | |
90 | .I number | |
91 | of lines. | |
f4ddf6ff | 92 | .TP |
4c5a6f3d BS |
93 | .BI + number |
94 | Start displaying each file at line | |
f4ddf6ff | 95 | .IR number . |
4c5a6f3d BS |
96 | .TP |
97 | .BI +/ string | |
98 | The | |
99 | .I string | |
100 | to be searched in each file before starting to display it. | |
c1da6d1e RM |
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. | |
f4ddf6ff | 107 | .SH COMMANDS |
6dbe3af9 | 108 | Interactive commands for |
f4ddf6ff | 109 | .B more |
6dbe3af9 | 110 | are based on |
f4ddf6ff | 111 | .BR vi (1). |
22853e4a | 112 | Some commands may be preceded by a decimal number, called k in the |
f4ddf6ff SK |
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 \ ? | |
01cc21f5 | 122 | Help; display a summary of these commands. If you forget all other |
f4ddf6ff SK |
123 | commands, remember this one. |
124 | .TP | |
125 | .B SPACE | |
6dbe3af9 | 126 | Display next k lines of text. Defaults to current screen size. |
f4ddf6ff SK |
127 | .TP |
128 | .B z | |
6dbe3af9 KZ |
129 | Display next k lines of text. Defaults to current screen size. Argument |
130 | becomes new default. | |
f4ddf6ff SK |
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 | |
6dbe3af9 KZ |
136 | Scroll k lines. Default is current scroll size, initially 11. Argument |
137 | becomes new default. | |
f4ddf6ff SK |
138 | .TP |
139 | .BR q \ or \ Q \ or \ INTERRUPT | |
6dbe3af9 | 140 | Exit. |
f4ddf6ff SK |
141 | .TP |
142 | .B s | |
6dbe3af9 | 143 | Skip forward k lines of text. Defaults to 1. |
f4ddf6ff SK |
144 | .TP |
145 | .B f | |
6dbe3af9 | 146 | Skip forward k screenfuls of text. Defaults to 1. |
f4ddf6ff SK |
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 | |
01cc21f5 BS |
152 | .B ' |
153 | Go to the place where the last search started. | |
f4ddf6ff SK |
154 | .TP |
155 | .B = | |
6dbe3af9 | 156 | Display current line number. |
f4ddf6ff SK |
157 | .TP |
158 | .B \&/pattern | |
6dbe3af9 | 159 | Search for kth occurrence of regular expression. Defaults to 1. |
f4ddf6ff SK |
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 | |
6dbe3af9 | 190 | Go to kth next file. Defaults to 1. |
f4ddf6ff | 191 | .TP |
01cc21f5 | 192 | .B :p |
6dbe3af9 | 193 | Go to kth previous file. Defaults to 1. |
f4ddf6ff SK |
194 | .TP |
195 | .B :f | |
196 | Display current file name and line number. | |
197 | .TP | |
198 | .B \&. | |
199 | Repeat previous command. | |
200 | .SH ENVIRONMENT | |
4c5a6f3d BS |
201 | The |
202 | .B more | |
203 | command respects the following environment variables, if they exist: | |
f4ddf6ff SK |
204 | .TP |
205 | .B MORE | |
6dbe3af9 | 206 | This variable may be set with favored options to |
f4ddf6ff SK |
207 | .BR more . |
208 | .TP | |
209 | .B SHELL | |
6dbe3af9 | 210 | Current shell in use (normally set by the shell at login time). |
f4ddf6ff SK |
211 | .TP |
212 | .B TERM | |
4c5a6f3d | 213 | The terminal type used by \fBmore\fR to get the terminal |
6dbe3af9 | 214 | characteristics necessary to manipulate the screen. |
f4ddf6ff SK |
215 | .TP |
216 | .B VISUAL | |
4c5a6f3d | 217 | The editor the user prefers. Invoked when command key |
f4ddf6ff SK |
218 | .I v |
219 | is pressed. | |
220 | .TP | |
221 | .B EDITOR | |
4c5a6f3d | 222 | The editor of choice when |
f4ddf6ff SK |
223 | .B VISUAL |
224 | is not specified. | |
225 | .SH SEE ALSO | |
f053ff1e MK |
226 | .BR less (1), |
227 | .BR vi (1) | |
f4ddf6ff | 228 | .SH AUTHORS |
6dbe3af9 KZ |
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 | |
f4ddf6ff | 234 | .SH HISTORY |
6dbe3af9 | 235 | The |
f4ddf6ff SK |
236 | .B more |
237 | command appeared in 3.0BSD. This man page documents | |
238 | .B more | |
6dbe3af9 KZ |
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. | |
f4ddf6ff | 242 | .SH AVAILABILITY |
601d12fb | 243 | The 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 |
245 | Linux Kernel Archive |
246 | .UE . |