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