Commit | Line | Data |
---|---|---|
362b077f C |
1 | |
2 | ||
3 | ||
4 | MORE(1) UNIX Programmer's Manual MORE(1) | |
5 | ||
6 | ||
7 | ||
8 | N\bNA\bAM\bME\bE | |
9 | more, page - file perusal filter for crt viewing | |
10 | ||
11 | S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS | |
12 | m\bmo\bor\bre\be [ -\b-c\bcd\bdf\bfl\bls\bsu\bu ] [ -\b-_\bn ] [ +\b+_\bl_\bi_\bn_\be_\bn_\bu_\bm_\bb_\be_\br ] [ +\b+/\b/_\bp_\ba_\bt_\bt_\be_\br_\bn ] [ name | |
13 | ... ] | |
14 | ||
15 | p\bpa\bag\bge\be _\bm_\bo_\br_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs | |
16 | ||
17 | D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN | |
18 | _\bM_\bo_\br_\be is a filter which allows examination of a continuous | |
19 | text one screenful at a time on a soft-copy terminal. It | |
20 | normally pauses after each screenful, printing --More-- at | |
21 | the bottom of the screen. If the user then types a carriage | |
22 | return, one more line is displayed. If the user hits a | |
23 | space, another screenful is displayed. Other possibilities | |
24 | are enumerated later. | |
25 | ||
26 | The command line options are: | |
27 | ||
28 | -_\bn An integer which is the size (in lines) of the window | |
29 | which _\bm_\bo_\br_\be will use instead of the default. | |
30 | ||
31 | -\b-c\bc _\bM_\bo_\br_\be will draw each page by beginning at the top of the | |
32 | screen and erasing each line just before it draws on | |
33 | it. This avoids scrolling the screen, making it easier | |
34 | to read while _\bm_\bo_\br_\be is writing. This option will be | |
35 | ignored if the terminal does not have the ability to | |
36 | clear to the end of a line. | |
37 | ||
38 | -\b-d\bd _\bM_\bo_\br_\be will prompt the user with the message "Press space | |
39 | to continue, 'q' to quit." at the end of each screen- | |
40 | ful, and will respond to subsequent illegal user input | |
41 | by printing "Press 'h' for instructions." instead of | |
42 | ringing the bell. This is useful if _\bm_\bo_\br_\be is being used | |
43 | as a filter in some setting, such as a class, where | |
44 | many users may be unsophisticated. | |
45 | ||
46 | -\b-f\bf This causes _\bm_\bo_\br_\be to count logical, rather than screen | |
47 | lines. That is, long lines are not folded. This | |
48 | option is recommended if _\bn_\br_\bo_\bf_\bf output is being piped | |
49 | through _\bu_\bl, since the latter may generate escape | |
50 | sequences. These escape sequences contain characters | |
51 | which would ordinarily occupy screen positions, but | |
52 | which do not print when they are sent to the terminal | |
53 | as part of an escape sequence. Thus _\bm_\bo_\br_\be may think | |
54 | that lines are longer than they actually are, and fold | |
55 | lines erroneously. | |
56 | ||
57 | -\b-l\bl Do not treat ^L (form feed) specially. If this option | |
58 | is not given, _\bm_\bo_\br_\be will pause after any line that con- | |
59 | tains a ^L, as if the end of a screenful had been | |
60 | ||
61 | ||
62 | ||
63 | Printed 7/9/88 June 5, 1986 1 | |
64 | ||
65 | ||
66 | ||
67 | ||
68 | ||
69 | ||
70 | MORE(1) UNIX Programmer's Manual MORE(1) | |
71 | ||
72 | ||
73 | ||
74 | reached. Also, if a file begins with a form feed, the | |
75 | screen will be cleared before the file is printed. | |
76 | ||
77 | -\b-s\bs Squeeze multiple blank lines from the output, producing | |
78 | only one blank line. Especially helpful when viewing | |
79 | _\bn_\br_\bo_\bf_\bf output, this option maximizes the useful informa- | |
80 | tion present on the screen. | |
81 | ||
82 | -\b-u\bu Normally, _\bm_\bo_\br_\be will handle underlining such as produced | |
83 | by _\bn_\br_\bo_\bf_\bf in a manner appropriate to the particular ter- | |
84 | minal: if the terminal can perform underlining or has | |
85 | a stand-out mode, _\bm_\bo_\br_\be will output appropriate escape | |
86 | sequences to enable underlining or stand-out mode for | |
87 | underlined information in the source file. The -_\bu | |
88 | option suppresses this processing. | |
89 | ||
90 | +\b+_\bl_\bi_\bn_\be_\bn_\bu_\bm_\bb_\be_\br | |
91 | Start up at _\bl_\bi_\bn_\be_\bn_\bu_\bm_\bb_\be_\br. | |
92 | ||
93 | +\b+/\b/_\bp_\ba_\bt_\bt_\be_\br_\bn | |
94 | Start up two lines before the line containing the regu- | |
95 | lar expression _\bp_\ba_\bt_\bt_\be_\br_\bn. | |
96 | ||
97 | If the program is invoked as _\bp_\ba_\bg_\be, then the screen is | |
98 | cleared before each screenful is printed (but only if a full | |
99 | screenful is being printed), and _\bk - 1 rather than _\bk - 2 | |
100 | lines are printed in each screenful, where _\bk is the number | |
101 | of lines the terminal can display. | |
102 | ||
103 | _\bM_\bo_\br_\be looks in the file /_\be_\bt_\bc/_\bt_\be_\br_\bm_\bc_\ba_\bp to determine terminal | |
104 | characteristics, and to determine the default window size. | |
105 | On a terminal capable of displaying 24 lines, the default | |
106 | window size is 22 lines. | |
107 | ||
108 | _\bM_\bo_\br_\be looks in the environment variable _\bM_\bO_\bR_\bE to pre-set any | |
109 | flags desired. For example, if you prefer to view files | |
110 | using the -_\bc mode of operation, the _\bc_\bs_\bh command _\bs_\be_\bt_\be_\bn_\bv _\bM_\bO_\bR_\bE | |
111 | -_\bc or the _\bs_\bh command sequence _\bM_\bO_\bR_\bE='-_\bc' ; _\be_\bx_\bp_\bo_\br_\bt _\bM_\bO_\bR_\bE would | |
112 | cause all invocations of _\bm_\bo_\br_\be , including invocations by | |
113 | programs such as _\bm_\ba_\bn and _\bm_\bs_\bg_\bs , to use this mode. Normally, | |
114 | the user will place the command sequence which sets up the | |
115 | _\bM_\bO_\bR_\bE environment variable in the ._\bc_\bs_\bh_\br_\bc or ._\bp_\br_\bo_\bf_\bi_\bl_\be file. | |
116 | ||
117 | If _\bm_\bo_\br_\be is reading from a file, rather than a pipe, then a | |
118 | percentage is displayed along with the --More-- prompt. | |
119 | This gives the fraction of the file (in characters, not | |
120 | lines) that has been read so far. | |
121 | ||
122 | Other sequences which may be typed when _\bm_\bo_\br_\be pauses, and | |
123 | their effects, are as follows (_\bi is an optional integer | |
124 | argument, defaulting to 1) : | |
125 | ||
126 | ||
127 | ||
128 | ||
129 | Printed 7/9/88 June 5, 1986 2 | |
130 | ||
131 | ||
132 | ||
133 | ||
134 | ||
135 | ||
136 | MORE(1) UNIX Programmer's Manual MORE(1) | |
137 | ||
138 | ||
139 | ||
140 | _\bi<space> | |
141 | display _\bi more lines, (or another screenful if no argu- | |
142 | ment is given) | |
143 | ||
144 | ^D display 11 more lines (a ``scroll''). If _\bi is given, | |
145 | then the scroll size is set to _\bi. | |
146 | ||
147 | d same as ^D (control-D) | |
148 | ||
149 | _\biz same as typing a space except that _\bi, if present, | |
150 | becomes the new window size. | |
151 | ||
152 | _\bis skip _\bi lines and print a screenful of lines | |
153 | ||
154 | _\bif skip _\bi screenfuls and print a screenful of lines | |
155 | ||
156 | _\bib skip back _\bi screenfuls and print a screenful of lines | |
157 | ||
158 | _\bi^B same as b | |
159 | ||
160 | q or Q | |
161 | Exit from _\bm_\bo_\br_\be. | |
162 | ||
163 | = Display the current line number. | |
164 | ||
165 | v Start up the editor _\bv_\bi at the current line. | |
166 | ||
167 | h Help command; give a description of all the _\bm_\bo_\br_\be com- | |
168 | mands. | |
169 | ||
170 | _\bi/expr | |
171 | search for the _\bi-th occurrence of the regular expres- | |
172 | sion _\be_\bx_\bp_\br. If there are less than _\bi occurrences of | |
173 | _\be_\bx_\bp_\br, and the input is a file (rather than a pipe), | |
174 | then the position in the file remains unchanged. Oth- | |
175 | erwise, a screenful is displayed, starting two lines | |
176 | before the place where the expression was found. The | |
177 | user's erase and kill characters may be used to edit | |
178 | the regular expression. Erasing back past the first | |
179 | column cancels the search command. | |
180 | ||
181 | _\bin search for the _\bi-th occurrence of the last regular | |
182 | expression entered. | |
183 | ||
184 | ' (single quote) Go to the point from which the last | |
185 | search started. If no search has been performed in the | |
186 | current file, this command goes back to the beginning | |
187 | of the file. | |
188 | ||
189 | !command | |
190 | invoke a shell with _\bc_\bo_\bm_\bm_\ba_\bn_\bd. The characters `%' and `!' | |
191 | in "command" are replaced with the current file name | |
192 | ||
193 | ||
194 | ||
195 | Printed 7/9/88 June 5, 1986 3 | |
196 | ||
197 | ||
198 | ||
199 | ||
200 | ||
201 | ||
202 | MORE(1) UNIX Programmer's Manual MORE(1) | |
203 | ||
204 | ||
205 | ||
206 | and the previous shell command respectively. If there | |
207 | is no current file name, `%' is not expanded. The | |
208 | sequences "\%" and "\!" are replaced by "%" and "!" | |
209 | respectively. | |
210 | ||
211 | _\bi:n skip to the _\bi-th next file given in the command line | |
212 | (skips to last file if n doesn't make sense) | |
213 | ||
214 | _\bi:p skip to the _\bi-th previous file given in the command | |
215 | line. If this command is given in the middle of print- | |
216 | ing out a file, then _\bm_\bo_\br_\be goes back to the beginning of | |
217 | the file. If _\bi doesn't make sense, _\bm_\bo_\br_\be skips back to | |
218 | the first file. If _\bm_\bo_\br_\be is not reading from a file, | |
219 | the bell is rung and nothing else happens. | |
220 | ||
221 | :f display the current file name and line number. | |
222 | ||
223 | :q or :Q | |
224 | exit from _\bm_\bo_\br_\be (same as q or Q). | |
225 | ||
226 | . (dot) repeat the previous command. | |
227 | ||
228 | The commands take effect immediately, i.e., it is not neces- | |
229 | sary to type a carriage return. Up to the time when the | |
230 | command character itself is given, the user may hit the line | |
231 | kill character to cancel the numerical argument being | |
232 | formed. In addition, the user may hit the erase character | |
233 | to redisplay the --More--(xx%) message. | |
234 | ||
235 | At any time when output is being sent to the terminal, the | |
236 | user can hit the quit key (normally control-\). _\bM_\bo_\br_\be will | |
237 | stop sending output, and will display the usual --More-- | |
238 | prompt. The user may then enter one of the above commands | |
239 | in the normal manner. Unfortunately, some output is lost | |
240 | when this is done, due to the fact that any characters wait- | |
241 | ing in the terminal's output queue are flushed when the quit | |
242 | signal occurs. | |
243 | ||
244 | The terminal is set to _\bn_\bo_\be_\bc_\bh_\bo mode by this program so that | |
245 | the output can be continuous. What you type will thus not | |
246 | show on your terminal, except for the / and ! commands. | |
247 | ||
248 | If the standard output is not a teletype, then _\bm_\bo_\br_\be acts | |
249 | just like _\bc_\ba_\bt, except that a header is printed before each | |
250 | file (if there is more than one). | |
251 | ||
252 | A sample usage of _\bm_\bo_\br_\be in previewing _\bn_\br_\bo_\bf_\bf output would be | |
253 | ||
254 | nroff -ms +2 doc.n | more -s | |
255 | ||
256 | F\bFI\bIL\bLE\bES\bS | |
257 | /etc/termcap Terminal data base | |
258 | ||
259 | ||
260 | ||
261 | Printed 7/9/88 June 5, 1986 4 | |
262 | ||
263 | ||
264 | ||
265 | ||
266 | ||
267 | ||
268 | MORE(1) UNIX Programmer's Manual MORE(1) | |
269 | ||
270 | ||
271 | ||
272 | /usr/lib/more.help Help file | |
273 | ||
274 | S\bSE\bEE\bE A\bAL\bLS\bSO\bO | |
275 | csh(1), man(1), msgs(1), script(1), sh(1), environ(7) | |
276 | ||
277 | B\bBU\bUG\bGS\bS | |
278 | Skipping backwards is too slow on large files. | |
279 | ||
280 | ||
281 | ||
282 | ||
283 | ||
284 | ||
285 | ||
286 | ||
287 | ||
288 | ||
289 | ||
290 | ||
291 | ||
292 | ||
293 | ||
294 | ||
295 | ||
296 | ||
297 | ||
298 | ||
299 | ||
300 | ||
301 | ||
302 | ||
303 | ||
304 | ||
305 | ||
306 | ||
307 | ||
308 | ||
309 | ||
310 | ||
311 | ||
312 | ||
313 | ||
314 | ||
315 | ||
316 | ||
317 | ||
318 | ||
319 | ||
320 | ||
321 | ||
322 | ||
323 | ||
324 | ||
325 | ||
326 | ||
327 | Printed 7/9/88 June 5, 1986 5 | |
328 | ||
329 | ||
330 |