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