Commit | Line | Data |
---|---|---|
c1b4c7c6 ES |
1 | .TH MORE 1 11/16/79 |
2 | .UC | |
3 | .SH NAME | |
4 | more \- file perusal filter for crt viewing | |
5 | .SH SYNOPSIS | |
6 | .B more | |
7 | [ | |
8 | .B \-d | |
9 | ] | |
10 | [ | |
11 | .B \-\fIn\fP | |
12 | ] | |
13 | [ | |
14 | .B +\fIlinenumber\fP | +/\fIpattern\fP | |
15 | ] | |
16 | [ | |
17 | name ... | |
18 | ] | |
19 | .SH DESCRIPTION | |
20 | .I More | |
21 | is a filter which allows examination of a continuous text | |
22 | one screenful at a time on a soft-copy terminal. | |
23 | It normally pauses after each screenful, printing --More-- | |
24 | at the bottom of the screen. | |
25 | If the user then types a carriage return, one more line is displayed. | |
26 | If the user hits a space, | |
27 | another screenful is displayed. | |
28 | If a space is preceded by an integer, that number of lines are printed. | |
29 | If the user hits d or control-D, | |
30 | 11 more lines are displayed (a `scroll'). | |
31 | .I More | |
32 | looks in the file | |
33 | .I /etc/termcap | |
34 | to determine terminal characteristics, | |
35 | and to determine the default window size. | |
36 | On a terminal capable of displaying 24 lines, | |
37 | the default window size is 22 lines. | |
38 | .PP | |
39 | Other sequences which may be typed when | |
40 | .I more | |
41 | pauses, and their effects, are as follows (\fIi\fP is an optional integer | |
42 | argument, defaulting to 1) : | |
43 | .PP | |
44 | .IP \fIi\fPz | |
45 | same as typing a space except that \fIi\fP, if present, becomes the new | |
46 | window size. | |
47 | .PP | |
48 | .IP \fIi\fPs | |
49 | skip \fIi\fP lines and print a screenful of lines | |
50 | .PP | |
51 | .IP \fIi\fPf | |
52 | skip \fIi\fP screenfuls and print a screenful of lines | |
53 | .PP | |
54 | .IP \fIi\fPn | |
55 | skip to the \fIi\fP-th next file given in the command line | |
56 | (skips to last file if n doesn't make sense) | |
57 | .PP | |
58 | .IP \fIi\fPp | |
59 | skip to the \fIi\fP-th previous file given in the command line. | |
60 | If this command is given in the middle of printing out a | |
61 | file, then | |
62 | .I more | |
63 | goes back to the beginning of the file. If \fIi\fP doesn't make sense, | |
64 | .I more | |
65 | skips back to the first file. | |
66 | If | |
67 | .I more | |
68 | is not reading from a file, the bell is rung and nothing else happens. | |
69 | .PP | |
70 | .IP q or Q | |
71 | Exit from more. | |
72 | .PP | |
73 | .IP \fIi\fP/expr | |
74 | search for the \fIi\fP-th occurrence of the regular expression \fIexpr\fP. | |
75 | If there are less than \fIi\fP occurrences of \fIexpr\fP, | |
76 | and the input is a file (rather than a pipe), | |
77 | then the position in the file remains unchanged. | |
78 | Otherwise, a screenful is displayed, starting two lines before the place | |
79 | where the expression was found. | |
80 | The user's erase and kill characters may be used to edit the regular | |
81 | expression. | |
82 | Erasing back past the first column cancels the search command. | |
83 | .PP | |
84 | .IP !command | |
85 | invoke a shell with \fIcommand\fP. | |
86 | .PP | |
87 | The commands take effect immediately, i.e., it is not necessary to | |
88 | type a carriage return. | |
89 | Up to the time when the command character itself is given, | |
90 | the user may hit his or her line kill character to cancel the numerical | |
91 | argument being formed. | |
92 | .PP | |
93 | At any time when output is being sent to the terminal, the user can | |
94 | hit the quit key (normally control\-\\). | |
95 | .I More | |
96 | will stop sending output, and will display the usual --More-- | |
97 | prompt. | |
98 | The user may then enter one of the above commands in the normal manner. | |
99 | Unfortunately, some output is lost when this is done, due to the | |
100 | fact that any characters waiting in the terminal's output queue | |
101 | are flushed when the quit signal occurs. | |
102 | .PP | |
103 | The terminal is set to | |
104 | .I noecho | |
105 | mode by this program so that the output can be continuous. | |
106 | What you type will thus not show on your terminal, except for the / and ! | |
107 | commands. | |
108 | .PP | |
109 | If the standard output is not a teletype, then | |
110 | .I more | |
111 | acts just like | |
112 | .I cat, | |
113 | except that a header is printed before each file (if there is | |
114 | more than one). | |
115 | .PP | |
116 | The | |
117 | .B \-n | |
118 | option is an integer which is the size (in lines) of the window which | |
119 | .I more | |
120 | will use instead of the default. | |
121 | The | |
122 | .B \-d | |
123 | option causes more to prompt the user with the message "Hit | |
124 | space to continue, Rubout to abort" at the end of each screenful. | |
125 | This is useful if | |
126 | .I more | |
127 | is being used as a filter in some setting, | |
128 | such as a class, | |
129 | where many users may be unsophisticated. | |
130 | The | |
131 | .B +\fIlinenumber\fP | |
132 | option causes more to start up at \fIlinenumber\fP, while the | |
133 | .B +/\fIpattern\fP | |
134 | option causes more to start up two lines before the line containing the | |
135 | regular expression \fIpattern\fP. | |
136 | .PP | |
137 | .DT | |
138 | A sample usage of | |
139 | .I more | |
140 | in previewing | |
141 | .I nroff | |
142 | output would be | |
143 | .PP | |
144 | nroff \-ms +2 doc.n | more | |
145 | .SH AUTHOR | |
146 | Eric Shienbrood | |
147 | .SH FILES | |
148 | .DT | |
149 | /etc/termcap Terminal data base | |
150 | .SH "SEE ALSO" | |
151 | script(1) | |
152 | .SH BUGS | |
153 | The function of | |
154 | .I more | |
155 | should be done optionally by the teletype driver in the system, | |
156 | akin to the ``more'' feature of the ITS systems at MIT. |