]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
aad107b6 MB |
2 | //// |
3 | Copyright (c) 1988, 1990 The Regents of the University of California. | |
4 | Copyright (c) 1988 Mark Nudleman | |
5 | All rights reserved. | |
6 | ||
7 | Redistribution and use in source and binary forms, with or without | |
8 | modification, are permitted provided that the following conditions | |
9 | are met: | |
10 | 1. Redistributions of source code must retain the above copyright | |
11 | notice, this list of conditions and the following disclaimer. | |
12 | 2. Redistributions in binary form must reproduce the above copyright | |
13 | notice, this list of conditions and the following disclaimer in the | |
14 | documentation and/or other materials provided with the distribution. | |
15 | 3. All advertising materials mentioning features or use of this software | |
16 | must display the following acknowledgement: | |
17 | This product includes software developed by the University of | |
18 | California, Berkeley and its contributors. | |
19 | 4. Neither the name of the University nor the names of its contributors | |
20 | may be used to endorse or promote products derived from this software | |
21 | without specific prior written permission. | |
22 | ||
23 | THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
24 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
25 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
26 | ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
27 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
28 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
29 | OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
30 | HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
31 | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
32 | OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
33 | SUCH DAMAGE. | |
34 | ||
35 | @(#)more.1 5.15 (Berkeley) 7/29/91 | |
36 | ||
37 | Copyright (c) 1992 Rik Faith (faith@cs.unc.edu) | |
38 | //// | |
39 | = more(1) | |
40 | :doctype: manpage | |
f42ed819 | 41 | :man manual: User Commands |
aad107b6 MB |
42 | :man source: util-linux {release-version} |
43 | :page-layout: base | |
44 | :command: more | |
45 | ||
46 | == NAME | |
47 | ||
ed07532a | 48 | more - display the contents of a file in a terminal |
aad107b6 MB |
49 | |
50 | == SYNOPSIS | |
51 | ||
bbeadfdd | 52 | *more* [options] _file_ ... |
aad107b6 MB |
53 | |
54 | == DESCRIPTION | |
55 | ||
56 | *more* is a filter for paging through text one screenful at a time. This version is especially primitive. Users should realize that *less*(1) provides *more*(1) emulation plus extensive enhancements. | |
57 | ||
58 | == OPTIONS | |
59 | ||
60 | Options are also taken from the environment variable *MORE* (make sure to precede them with a dash (*-*)) but command-line options will override those. | |
61 | ||
62 | *-d*, *--silent*:: | |
bbeadfdd | 63 | Prompt with "[Press space to continue, 'q' to quit.]", and display "[Press 'h' for instructions.]" instead of ringing the bell when an illegal key is pressed. |
aad107b6 MB |
64 | |
65 | *-l*, *--logical*:: | |
bbeadfdd | 66 | Do not pause after any line containing a *^L* (form feed). |
aad107b6 | 67 | |
df6b29d3 | 68 | *-e*, *--exit-on-eof*:: |
28b391ce | 69 | Exit on End-Of-File, enabled by default if POSIXLY_CORRECT environment variable is not set or if not executed on terminal. |
df6b29d3 | 70 | |
aad107b6 | 71 | *-f*, *--no-pause*:: |
bbeadfdd | 72 | Count logical lines, rather than screen lines (i.e., long lines are not folded). |
aad107b6 MB |
73 | |
74 | *-p*, *--print-over*:: | |
bbeadfdd | 75 | Do not scroll. Instead, clear the whole screen and then display the text. Notice that this option is switched on automatically if the executable is named *page*. |
aad107b6 MB |
76 | |
77 | *-c*, *--clean-print*:: | |
bbeadfdd | 78 | Do not scroll. Instead, paint each screen from the top, clearing the remainder of each line as it is displayed. |
aad107b6 MB |
79 | |
80 | *-s*, *--squeeze*:: | |
bbeadfdd | 81 | Squeeze multiple blank lines into one. |
aad107b6 MB |
82 | |
83 | *-u*, *--plain*:: | |
bbeadfdd | 84 | Suppress underlining. This option is silently ignored as backwards compatibility. |
aad107b6 MB |
85 | |
86 | *-n*, *--lines* _number_:: | |
bbeadfdd | 87 | Specify the _number_ of lines per screenful. The _number_ argument is a positive decimal integer. The *--lines* option shall override any values obtained from any other source, such as number of lines reported by terminal. |
aad107b6 MB |
88 | |
89 | **-**__number__:: | |
bbeadfdd | 90 | A numeric option means the same as *--lines* option argument. |
aad107b6 MB |
91 | |
92 | **+**__number__:: | |
bbeadfdd | 93 | Start displaying each file at line _number_. |
aad107b6 | 94 | |
bbeadfdd MB |
95 | **+**/__string__:: |
96 | The _string_ to be searched in each file before starting to display it. | |
aad107b6 | 97 | |
2b2d3172 | 98 | include::man-common/help-version.adoc[] |
aad107b6 MB |
99 | |
100 | == COMMANDS | |
101 | ||
99157f44 | 102 | Interactive commands for *more* are based on *vi*(1). Some commands may be preceded by a decimal number, called k in the descriptions below. In the following descriptions, *^X* means *control-X*. |
aad107b6 | 103 | |
aad107b6 | 104 | *h* or *?*:: |
bbeadfdd | 105 | Help; display a summary of these commands. If you forget all other commands, remember this one. |
aad107b6 MB |
106 | |
107 | *SPACE*:: | |
bbeadfdd | 108 | Display next k lines of text. Defaults to current screen size. |
aad107b6 MB |
109 | |
110 | *z*:: | |
bbeadfdd | 111 | Display next k lines of text. Defaults to current screen size. Argument becomes new default. |
aad107b6 MB |
112 | |
113 | *RETURN*:: | |
bbeadfdd | 114 | Display next k lines of text. Defaults to 1. Argument becomes new default. |
aad107b6 MB |
115 | |
116 | *d* or *^D*:: | |
bbeadfdd | 117 | Scroll k lines. Default is current scroll size, initially 11. Argument becomes new default. |
aad107b6 MB |
118 | |
119 | *q* or *Q* or *INTERRUPT*:: | |
bbeadfdd | 120 | Exit. |
aad107b6 MB |
121 | |
122 | *s*:: | |
bbeadfdd | 123 | Skip forward k lines of text. Defaults to 1. |
aad107b6 MB |
124 | |
125 | *f*:: | |
bbeadfdd | 126 | Skip forward k screenfuls of text. Defaults to 1. |
aad107b6 MB |
127 | |
128 | *b* or *^B*:: | |
bbeadfdd | 129 | Skip backwards k screenfuls of text. Defaults to 1. Only works with files, not pipes. |
aad107b6 MB |
130 | |
131 | *'*:: | |
bbeadfdd | 132 | Go to the place where the last search started. |
aad107b6 MB |
133 | |
134 | *=*:: | |
bbeadfdd | 135 | Display current line number. |
aad107b6 MB |
136 | |
137 | */pattern*:: | |
bbeadfdd | 138 | Search for kth occurrence of regular expression. Defaults to 1. |
aad107b6 MB |
139 | |
140 | *n*:: | |
bbeadfdd | 141 | Search for kth occurrence of last regular expression. Defaults to 1. |
aad107b6 MB |
142 | |
143 | *!command* or *:!command*:: | |
bbeadfdd | 144 | Execute _command_ in a subshell. |
aad107b6 MB |
145 | |
146 | *v*:: | |
bbeadfdd | 147 | Start up an editor at current line. The editor is taken from the environment variable *VISUAL* if defined, or *EDITOR* if *VISUAL* is not defined, or defaults to *vi*(1) if neither *VISUAL* nor *EDITOR* is defined. |
aad107b6 MB |
148 | |
149 | *^L*:: | |
bbeadfdd | 150 | Redraw screen. |
aad107b6 MB |
151 | |
152 | *:n*:: | |
bbeadfdd | 153 | Go to kth next file. Defaults to 1. |
aad107b6 MB |
154 | |
155 | *:p*:: | |
bbeadfdd | 156 | Go to kth previous file. Defaults to 1. |
aad107b6 MB |
157 | |
158 | *:f*:: | |
bbeadfdd | 159 | Display current file name and line number. |
aad107b6 MB |
160 | |
161 | *.*:: | |
bbeadfdd | 162 | Repeat previous command. |
aad107b6 MB |
163 | |
164 | == ENVIRONMENT | |
165 | ||
166 | The *more* command respects the following environment variables, if they exist: | |
167 | ||
168 | *MORE*:: | |
bbeadfdd | 169 | This variable may be set with favored options to *more*. |
aad107b6 MB |
170 | |
171 | *SHELL*:: | |
bbeadfdd | 172 | Current shell in use (normally set by the shell at login time). |
aad107b6 MB |
173 | |
174 | *TERM*:: | |
bbeadfdd | 175 | The terminal type used by *more* to get the terminal characteristics necessary to manipulate the screen. |
aad107b6 MB |
176 | |
177 | *VISUAL*:: | |
bbeadfdd | 178 | The editor the user prefers. Invoked when command key _v_ is pressed. |
aad107b6 MB |
179 | |
180 | *EDITOR*:: | |
bbeadfdd | 181 | The editor of choice when *VISUAL* is not specified. |
aad107b6 | 182 | |
224410df KZ |
183 | *POSIXLY_CORRECT*:: |
184 | Disable exit-on-eof (see option *-e* for more details). | |
185 | ||
aad107b6 MB |
186 | == HISTORY |
187 | ||
188 | The *more* command appeared in 3.0BSD. This man page documents *more* version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux community. Documentation was produced using several other versions of the man page, and extensive inspection of the source code. | |
189 | ||
190 | == AUTHORS | |
191 | ||
192 | Eric Shienbrood, UC Berkeley. | |
193 | ||
194 | Modified by Geoff Peck, UCB to add underlining, single spacing. | |
195 | ||
196 | Modified by John Foderaro, UCB to add -c and MORE environment variable. | |
197 | ||
aad107b6 MB |
198 | == SEE ALSO |
199 | ||
200 | *less*(1), | |
201 | *vi*(1) | |
202 | ||
625e9c61 | 203 | include::man-common/bugreports.adoc[] |
aad107b6 | 204 | |
625e9c61 | 205 | include::man-common/footer.adoc[] |
aad107b6 MB |
206 | |
207 | ifdef::translation[] | |
625e9c61 | 208 | include::man-common/translation.adoc[] |
aad107b6 | 209 | endif::[] |