annotate miscellany/less-177/less.man @ 0:bce86c4163a3

Initial revision
author kono
date Mon, 18 Apr 2005 23:46:02 +0900
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
2
bce86c4163a3 Initial revision
kono
parents:
diff changeset
3
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 NNAAMMEE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 less - opposite of more
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 SSYYNNOOPPSSIISS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 lleessss --??
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 lleessss [[--[[++]]aaBBccCCddeeEEffHHiimmMMnnNNqqQQrrssSSuuUUww]]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 [[--bb _b_u_f_s]] [[--hh _l_i_n_e_s]] [[--jj _l_i_n_e]] [[--kk _k_e_y_f_i_l_e]]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 [[--{{ooOO}} _l_o_g_f_i_l_e]] [[--pp _p_a_t_t_e_r_n]] [[--PP _p_r_o_m_p_t]] [[--tt _t_a_g]]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 [[--TT _t_a_g_f_i_l_e]] [[--xx _t_a_b]] [[--yy _l_i_n_e_s]] [[--[[zz]] _l_i_n_e_s]]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 [[++[[++]]_c_m_d]] [[_f_i_l_e_n_a_m_e]]......
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 DDEESSCCRRIIPPTTIIOONN
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 _L_e_s_s is a program similar to _m_o_r_e (1), but which allows
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 backward movement in the file as well as forward movement.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 Also, _l_e_s_s does not have to read the entire input file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 before starting, so with large input files it starts up
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 faster than text editors like _v_i (1). _L_e_s_s uses termcap
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 (or terminfo on some systems), so it can run on a variety
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 of terminals. There is even limited support for hardcopy
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 terminals. (On a hardcopy terminal, lines which should be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 printed at the top of the screen are prefixed with an up-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 arrow.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 Commands are based on both _m_o_r_e and _v_i_. Commands may be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 preceded by a decimal number, called N in the descriptions
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33 below. The number is used by some commands, as indicated.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 CCOOMMMMAANNDDSS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 In the following descriptions, ^X means control-X. ESC
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 stands for the ESCAPE key; for example ESC-v means the two
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 character sequence "ESCAPE", then "v".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41 h or H Help: display a summary of these commands. If you
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 forget all the other commands, remember this one.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 SPACE or ^V or f or ^F
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 Scroll forward N lines, default one window (see
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 option -z below). If N is more than the screen
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 size, only the final screenful is displayed. Warn-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 ing: some systems use ^V as a special literaliza-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 tion character.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 z Like SPACE, but if N is specified, it becomes the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 new window size.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 RETURN or ^N or e or ^E or j or ^J
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 Scroll forward N lines, default 1. The entire N
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 lines are displayed, even if N is more than the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 screen size.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 d or ^D
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74 Scroll forward N lines, default one half of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 screen size. If N is specified, it becomes the new
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 default for subsequent d and u commands.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77
bce86c4163a3 Initial revision
kono
parents:
diff changeset
78
bce86c4163a3 Initial revision
kono
parents:
diff changeset
79 b or ^B or ESC-v
bce86c4163a3 Initial revision
kono
parents:
diff changeset
80 Scroll backward N lines, default one window (see
bce86c4163a3 Initial revision
kono
parents:
diff changeset
81 option -z below). If N is more than the screen
bce86c4163a3 Initial revision
kono
parents:
diff changeset
82 size, only the final screenful is displayed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
83
bce86c4163a3 Initial revision
kono
parents:
diff changeset
84
bce86c4163a3 Initial revision
kono
parents:
diff changeset
85 w Like ESC-v, but if N is specified, it becomes the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
86 new window size.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
87
bce86c4163a3 Initial revision
kono
parents:
diff changeset
88
bce86c4163a3 Initial revision
kono
parents:
diff changeset
89 y or ^Y or ^P or k or ^K
bce86c4163a3 Initial revision
kono
parents:
diff changeset
90 Scroll backward N lines, default 1. The entire N
bce86c4163a3 Initial revision
kono
parents:
diff changeset
91 lines are displayed, even if N is more than the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
92 screen size. Warning: some systems use ^Y as a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
93 special job control character.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
94
bce86c4163a3 Initial revision
kono
parents:
diff changeset
95
bce86c4163a3 Initial revision
kono
parents:
diff changeset
96 u or ^U
bce86c4163a3 Initial revision
kono
parents:
diff changeset
97 Scroll backward N lines, default one half of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
98 screen size. If N is specified, it becomes the new
bce86c4163a3 Initial revision
kono
parents:
diff changeset
99 default for subsequent d and u commands.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
100
bce86c4163a3 Initial revision
kono
parents:
diff changeset
101
bce86c4163a3 Initial revision
kono
parents:
diff changeset
102 r or ^R or ^L
bce86c4163a3 Initial revision
kono
parents:
diff changeset
103 Repaint the screen.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
104
bce86c4163a3 Initial revision
kono
parents:
diff changeset
105
bce86c4163a3 Initial revision
kono
parents:
diff changeset
106 R Repaint the screen, discarding any buffered input.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
107 Useful if the file is changing while it is being
bce86c4163a3 Initial revision
kono
parents:
diff changeset
108 viewed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
109
bce86c4163a3 Initial revision
kono
parents:
diff changeset
110
bce86c4163a3 Initial revision
kono
parents:
diff changeset
111 F Scroll forward, and keep trying to read when the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
112 end of file is reached. Normally this command
bce86c4163a3 Initial revision
kono
parents:
diff changeset
113 would be used when already at the end of the file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
114 It is a way to monitor the tail of a file which is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
115 growing while it is being viewed. (The behavior is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
116 similar to the "tail -f" command.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
117
bce86c4163a3 Initial revision
kono
parents:
diff changeset
118
bce86c4163a3 Initial revision
kono
parents:
diff changeset
119 g or < or ESC-<
bce86c4163a3 Initial revision
kono
parents:
diff changeset
120 Go to line N in the file, default 1 (beginning of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
121 file). (Warning: this may be slow if N is large.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
122
bce86c4163a3 Initial revision
kono
parents:
diff changeset
123
bce86c4163a3 Initial revision
kono
parents:
diff changeset
124 G or > or ESC->
bce86c4163a3 Initial revision
kono
parents:
diff changeset
125 Go to line N in the file, default the end of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
126 file. (Warning: this may be slow if N is large, or
bce86c4163a3 Initial revision
kono
parents:
diff changeset
127
bce86c4163a3 Initial revision
kono
parents:
diff changeset
128
bce86c4163a3 Initial revision
kono
parents:
diff changeset
129
bce86c4163a3 Initial revision
kono
parents:
diff changeset
130 2
bce86c4163a3 Initial revision
kono
parents:
diff changeset
131
bce86c4163a3 Initial revision
kono
parents:
diff changeset
132
bce86c4163a3 Initial revision
kono
parents:
diff changeset
133
bce86c4163a3 Initial revision
kono
parents:
diff changeset
134
bce86c4163a3 Initial revision
kono
parents:
diff changeset
135
bce86c4163a3 Initial revision
kono
parents:
diff changeset
136 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
137
bce86c4163a3 Initial revision
kono
parents:
diff changeset
138
bce86c4163a3 Initial revision
kono
parents:
diff changeset
139 if N is not specified and standard input, rather
bce86c4163a3 Initial revision
kono
parents:
diff changeset
140 than a file, is being read.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
141
bce86c4163a3 Initial revision
kono
parents:
diff changeset
142
bce86c4163a3 Initial revision
kono
parents:
diff changeset
143 p or % Go to a position N percent into the file. N should
bce86c4163a3 Initial revision
kono
parents:
diff changeset
144 be between 0 and 100. (This works if standard
bce86c4163a3 Initial revision
kono
parents:
diff changeset
145 input is being read, but only if _l_e_s_s has already
bce86c4163a3 Initial revision
kono
parents:
diff changeset
146 read to the end of the file. It is always fast,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
147 but not always useful.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
148
bce86c4163a3 Initial revision
kono
parents:
diff changeset
149
bce86c4163a3 Initial revision
kono
parents:
diff changeset
150 { If a left curly bracket appears in the top line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
151 displayed on the screen, the { command will go to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
152 the matching right curly bracket. The matching
bce86c4163a3 Initial revision
kono
parents:
diff changeset
153 right curly bracket is positioned on the bottom
bce86c4163a3 Initial revision
kono
parents:
diff changeset
154 line of the screen. If there is more than one left
bce86c4163a3 Initial revision
kono
parents:
diff changeset
155 curly bracket on the top line, a number N may be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
156 used to specify the N-th bracket on the line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
157
bce86c4163a3 Initial revision
kono
parents:
diff changeset
158
bce86c4163a3 Initial revision
kono
parents:
diff changeset
159 } If a right curly bracket appears in the bottom line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
160 displayed on the screen, the } command will go to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
161 the matching left curly bracket. The matching left
bce86c4163a3 Initial revision
kono
parents:
diff changeset
162 curly bracket is positioned on the top line of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
163 screen. If there is more than one right curly
bce86c4163a3 Initial revision
kono
parents:
diff changeset
164 bracket on the top line, a number N may be used to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
165 specify the N-th bracket on the line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
166
bce86c4163a3 Initial revision
kono
parents:
diff changeset
167
bce86c4163a3 Initial revision
kono
parents:
diff changeset
168 ( Like {, but applies to parentheses rather than
bce86c4163a3 Initial revision
kono
parents:
diff changeset
169 curly brackets.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
170
bce86c4163a3 Initial revision
kono
parents:
diff changeset
171
bce86c4163a3 Initial revision
kono
parents:
diff changeset
172 ) Like }, but applies to parentheses rather than
bce86c4163a3 Initial revision
kono
parents:
diff changeset
173 curly brackets.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
174
bce86c4163a3 Initial revision
kono
parents:
diff changeset
175
bce86c4163a3 Initial revision
kono
parents:
diff changeset
176 [ Like {, but applies to square brackets rather than
bce86c4163a3 Initial revision
kono
parents:
diff changeset
177 curly brackets.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
178
bce86c4163a3 Initial revision
kono
parents:
diff changeset
179
bce86c4163a3 Initial revision
kono
parents:
diff changeset
180 ] Like }, but applies to square brackets rather than
bce86c4163a3 Initial revision
kono
parents:
diff changeset
181 curly brackets.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
182
bce86c4163a3 Initial revision
kono
parents:
diff changeset
183
bce86c4163a3 Initial revision
kono
parents:
diff changeset
184 ESC-^F Followed by two characters, acts like {, but uses
bce86c4163a3 Initial revision
kono
parents:
diff changeset
185 the two characters as open and close brackets,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
186 respectively. For example, "ESC ^F < >" could be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
187 used to go forward to the > which matches the < in
bce86c4163a3 Initial revision
kono
parents:
diff changeset
188 the top displayed line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
189
bce86c4163a3 Initial revision
kono
parents:
diff changeset
190 ESC-^B Followed by two characters, acts like }, but uses
bce86c4163a3 Initial revision
kono
parents:
diff changeset
191 the two characters as open and close brackets,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
192 respectively. For example, "ESC ^B < >" could be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
193
bce86c4163a3 Initial revision
kono
parents:
diff changeset
194
bce86c4163a3 Initial revision
kono
parents:
diff changeset
195
bce86c4163a3 Initial revision
kono
parents:
diff changeset
196 3
bce86c4163a3 Initial revision
kono
parents:
diff changeset
197
bce86c4163a3 Initial revision
kono
parents:
diff changeset
198
bce86c4163a3 Initial revision
kono
parents:
diff changeset
199
bce86c4163a3 Initial revision
kono
parents:
diff changeset
200
bce86c4163a3 Initial revision
kono
parents:
diff changeset
201
bce86c4163a3 Initial revision
kono
parents:
diff changeset
202 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
203
bce86c4163a3 Initial revision
kono
parents:
diff changeset
204
bce86c4163a3 Initial revision
kono
parents:
diff changeset
205 used to go backward to the < which matches the > in
bce86c4163a3 Initial revision
kono
parents:
diff changeset
206 the bottom displayed line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
207
bce86c4163a3 Initial revision
kono
parents:
diff changeset
208 m Followed by any lowercase letter, marks the current
bce86c4163a3 Initial revision
kono
parents:
diff changeset
209 position with that letter.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
210
bce86c4163a3 Initial revision
kono
parents:
diff changeset
211
bce86c4163a3 Initial revision
kono
parents:
diff changeset
212 ' (Single quote.) Followed by any lowercase letter,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
213 returns to the position which was previously marked
bce86c4163a3 Initial revision
kono
parents:
diff changeset
214 with that letter. Followed by another single
bce86c4163a3 Initial revision
kono
parents:
diff changeset
215 quote, returns to the position at which the last
bce86c4163a3 Initial revision
kono
parents:
diff changeset
216 "large" movement command was executed. Followed by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
217 a ^ or $, jumps to the beginning or end of the file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
218 respectively. Marks are preserved when a new file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
219 is examined, so the ' command can be used to switch
bce86c4163a3 Initial revision
kono
parents:
diff changeset
220 between input files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
221
bce86c4163a3 Initial revision
kono
parents:
diff changeset
222
bce86c4163a3 Initial revision
kono
parents:
diff changeset
223 ^X^X Same as single quote.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
224
bce86c4163a3 Initial revision
kono
parents:
diff changeset
225
bce86c4163a3 Initial revision
kono
parents:
diff changeset
226 /pattern
bce86c4163a3 Initial revision
kono
parents:
diff changeset
227 Search forward in the file for the N-th line con-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
228 taining the pattern. N defaults to 1. The pattern
bce86c4163a3 Initial revision
kono
parents:
diff changeset
229 is a regular expression, as recognized by _e_d_. The
bce86c4163a3 Initial revision
kono
parents:
diff changeset
230 search starts at the second line displayed (but see
bce86c4163a3 Initial revision
kono
parents:
diff changeset
231 the -a and -j options, which change this).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
232
bce86c4163a3 Initial revision
kono
parents:
diff changeset
233 Certain characters are special if entered at the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
234 beginning of the pattern; they modify the type of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
235 search rather than become part of the pattern:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
236
bce86c4163a3 Initial revision
kono
parents:
diff changeset
237 ! Search for lines which do NOT match the pat-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
238 tern.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
239
bce86c4163a3 Initial revision
kono
parents:
diff changeset
240 * Search multiple files. That is, if the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
241 search reaches the end of the current file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
242 without finding a match, the search contin-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
243 ues in the next file in the command line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
244 list.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
245
bce86c4163a3 Initial revision
kono
parents:
diff changeset
246 @ Begin the search at the first line of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
247 first file in the command line list, regard-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
248 less of what is currently displayed on the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
249 screen or the settings of the -a or -j
bce86c4163a3 Initial revision
kono
parents:
diff changeset
250 options.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
251
bce86c4163a3 Initial revision
kono
parents:
diff changeset
252
bce86c4163a3 Initial revision
kono
parents:
diff changeset
253 ?pattern
bce86c4163a3 Initial revision
kono
parents:
diff changeset
254 Search backward in the file for the N-th line con-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
255 taining the pattern. The search starts at the line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
256 immediately before the top line displayed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
257
bce86c4163a3 Initial revision
kono
parents:
diff changeset
258 Certain characters are special as in the / command:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
259
bce86c4163a3 Initial revision
kono
parents:
diff changeset
260
bce86c4163a3 Initial revision
kono
parents:
diff changeset
261
bce86c4163a3 Initial revision
kono
parents:
diff changeset
262 4
bce86c4163a3 Initial revision
kono
parents:
diff changeset
263
bce86c4163a3 Initial revision
kono
parents:
diff changeset
264
bce86c4163a3 Initial revision
kono
parents:
diff changeset
265
bce86c4163a3 Initial revision
kono
parents:
diff changeset
266
bce86c4163a3 Initial revision
kono
parents:
diff changeset
267
bce86c4163a3 Initial revision
kono
parents:
diff changeset
268 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
269
bce86c4163a3 Initial revision
kono
parents:
diff changeset
270
bce86c4163a3 Initial revision
kono
parents:
diff changeset
271 ! Search for lines which do NOT match the pat-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
272 tern.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
273
bce86c4163a3 Initial revision
kono
parents:
diff changeset
274 * Search multiple files. That is, if the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
275 search reaches the beginning of the current
bce86c4163a3 Initial revision
kono
parents:
diff changeset
276 file without finding a match, the search
bce86c4163a3 Initial revision
kono
parents:
diff changeset
277 continues in the previous file in the com-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
278 mand line list.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
279
bce86c4163a3 Initial revision
kono
parents:
diff changeset
280 @ Begin the search at the last line of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
281 last file in the command line list, regard-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
282 less of what is currently displayed on the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
283 screen or the settings of the -a or -j
bce86c4163a3 Initial revision
kono
parents:
diff changeset
284 options.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
285
bce86c4163a3 Initial revision
kono
parents:
diff changeset
286
bce86c4163a3 Initial revision
kono
parents:
diff changeset
287 ESC-/pattern
bce86c4163a3 Initial revision
kono
parents:
diff changeset
288 Same as "/*".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
289
bce86c4163a3 Initial revision
kono
parents:
diff changeset
290
bce86c4163a3 Initial revision
kono
parents:
diff changeset
291 ESC-?pattern
bce86c4163a3 Initial revision
kono
parents:
diff changeset
292 Same as "?*".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
293
bce86c4163a3 Initial revision
kono
parents:
diff changeset
294
bce86c4163a3 Initial revision
kono
parents:
diff changeset
295 n Repeat previous search, for N-th line containing
bce86c4163a3 Initial revision
kono
parents:
diff changeset
296 the last pattern. If the previous search was modi-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
297 fied by !, the search is made for the N-th line NOT
bce86c4163a3 Initial revision
kono
parents:
diff changeset
298 containing the pattern. If the previous search was
bce86c4163a3 Initial revision
kono
parents:
diff changeset
299 modified by *, the search continues in the next (or
bce86c4163a3 Initial revision
kono
parents:
diff changeset
300 previous) file if not satisfied in the current
bce86c4163a3 Initial revision
kono
parents:
diff changeset
301 file. There is no effect if the previous search
bce86c4163a3 Initial revision
kono
parents:
diff changeset
302 was modified by @.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
303
bce86c4163a3 Initial revision
kono
parents:
diff changeset
304
bce86c4163a3 Initial revision
kono
parents:
diff changeset
305 N Repeat previous search, but in the reverse direc-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
306 tion.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
307
bce86c4163a3 Initial revision
kono
parents:
diff changeset
308
bce86c4163a3 Initial revision
kono
parents:
diff changeset
309 ESC-n Repeat previous search, but crossing file bound-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
310 aries. The effect is as if the previous search
bce86c4163a3 Initial revision
kono
parents:
diff changeset
311 were modified by *.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
312
bce86c4163a3 Initial revision
kono
parents:
diff changeset
313
bce86c4163a3 Initial revision
kono
parents:
diff changeset
314 ESC-N Repeat previous search, but in the reverse direc-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
315 tion and crossing file boundaries.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
316
bce86c4163a3 Initial revision
kono
parents:
diff changeset
317
bce86c4163a3 Initial revision
kono
parents:
diff changeset
318 :e [filename]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
319 Examine a new file. If the filename is missing,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
320 the "current" file (see the :n and :p commands
bce86c4163a3 Initial revision
kono
parents:
diff changeset
321 below) from the list of files in the command line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
322 is re-examined. A percent sign (%) in the filename
bce86c4163a3 Initial revision
kono
parents:
diff changeset
323 is replaced by the name of the current file. A
bce86c4163a3 Initial revision
kono
parents:
diff changeset
324 pound sign (#) is replaced by the name of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
325
bce86c4163a3 Initial revision
kono
parents:
diff changeset
326
bce86c4163a3 Initial revision
kono
parents:
diff changeset
327
bce86c4163a3 Initial revision
kono
parents:
diff changeset
328 5
bce86c4163a3 Initial revision
kono
parents:
diff changeset
329
bce86c4163a3 Initial revision
kono
parents:
diff changeset
330
bce86c4163a3 Initial revision
kono
parents:
diff changeset
331
bce86c4163a3 Initial revision
kono
parents:
diff changeset
332
bce86c4163a3 Initial revision
kono
parents:
diff changeset
333
bce86c4163a3 Initial revision
kono
parents:
diff changeset
334 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
335
bce86c4163a3 Initial revision
kono
parents:
diff changeset
336
bce86c4163a3 Initial revision
kono
parents:
diff changeset
337 previously examined file. The filename is inserted
bce86c4163a3 Initial revision
kono
parents:
diff changeset
338 into the command line list of files so that it can
bce86c4163a3 Initial revision
kono
parents:
diff changeset
339 be seen by subsequent :n and :p commands. If the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
340 filename consists of several files, they are all
bce86c4163a3 Initial revision
kono
parents:
diff changeset
341 inserted into the list of files and the first one
bce86c4163a3 Initial revision
kono
parents:
diff changeset
342 is examined.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
343
bce86c4163a3 Initial revision
kono
parents:
diff changeset
344
bce86c4163a3 Initial revision
kono
parents:
diff changeset
345 ^X^V or E
bce86c4163a3 Initial revision
kono
parents:
diff changeset
346 Same as :e. Warning: some systems use ^V as a spe-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
347 cial literalization character.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
348
bce86c4163a3 Initial revision
kono
parents:
diff changeset
349
bce86c4163a3 Initial revision
kono
parents:
diff changeset
350 :n Examine the next file (from the list of files given
bce86c4163a3 Initial revision
kono
parents:
diff changeset
351 in the command line). If a number N is specified,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
352 the N-th next file is examined.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
353
bce86c4163a3 Initial revision
kono
parents:
diff changeset
354
bce86c4163a3 Initial revision
kono
parents:
diff changeset
355 :p Examine the previous file in the command line list.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
356 If a number N is specified, the N-th previous file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
357 is examined.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
358
bce86c4163a3 Initial revision
kono
parents:
diff changeset
359
bce86c4163a3 Initial revision
kono
parents:
diff changeset
360 :x Examine the first file in the command line list.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
361 If a number N is specified, the N-th file in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
362 list is examined.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
363
bce86c4163a3 Initial revision
kono
parents:
diff changeset
364
bce86c4163a3 Initial revision
kono
parents:
diff changeset
365 = or ^G or :f
bce86c4163a3 Initial revision
kono
parents:
diff changeset
366 Prints some information about the file being
bce86c4163a3 Initial revision
kono
parents:
diff changeset
367 viewed, including its name and the line number and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
368 byte offset of the bottom line being displayed. If
bce86c4163a3 Initial revision
kono
parents:
diff changeset
369 possible, it also prints the length of the file,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
370 the number of lines in the file and the percent of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
371 the file above the last displayed line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
372
bce86c4163a3 Initial revision
kono
parents:
diff changeset
373
bce86c4163a3 Initial revision
kono
parents:
diff changeset
374 - Followed by one of the command line option letters
bce86c4163a3 Initial revision
kono
parents:
diff changeset
375 (see below), this will change the setting of that
bce86c4163a3 Initial revision
kono
parents:
diff changeset
376 option and print a message describing the new set-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
377 ting. If the option letter has a numeric value
bce86c4163a3 Initial revision
kono
parents:
diff changeset
378 (such as -b or -h), or a string value (such as -P
bce86c4163a3 Initial revision
kono
parents:
diff changeset
379 or -t), a new value may be entered after the option
bce86c4163a3 Initial revision
kono
parents:
diff changeset
380 letter. If no new value is entered, a message
bce86c4163a3 Initial revision
kono
parents:
diff changeset
381 describing the current setting is printed and noth-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
382 ing is changed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
383
bce86c4163a3 Initial revision
kono
parents:
diff changeset
384
bce86c4163a3 Initial revision
kono
parents:
diff changeset
385 -+ Followed by one of the command line option letters
bce86c4163a3 Initial revision
kono
parents:
diff changeset
386 (see below), this will reset the option to its
bce86c4163a3 Initial revision
kono
parents:
diff changeset
387 default setting and print a message describing the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
388 new setting. (The "-+_X" command does the same
bce86c4163a3 Initial revision
kono
parents:
diff changeset
389 thing as "-+_X" on the command line.) This does not
bce86c4163a3 Initial revision
kono
parents:
diff changeset
390 work for string-valued options.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
391
bce86c4163a3 Initial revision
kono
parents:
diff changeset
392
bce86c4163a3 Initial revision
kono
parents:
diff changeset
393
bce86c4163a3 Initial revision
kono
parents:
diff changeset
394 6
bce86c4163a3 Initial revision
kono
parents:
diff changeset
395
bce86c4163a3 Initial revision
kono
parents:
diff changeset
396
bce86c4163a3 Initial revision
kono
parents:
diff changeset
397
bce86c4163a3 Initial revision
kono
parents:
diff changeset
398
bce86c4163a3 Initial revision
kono
parents:
diff changeset
399
bce86c4163a3 Initial revision
kono
parents:
diff changeset
400 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
401
bce86c4163a3 Initial revision
kono
parents:
diff changeset
402
bce86c4163a3 Initial revision
kono
parents:
diff changeset
403 -- Followed by one of the command line option letters
bce86c4163a3 Initial revision
kono
parents:
diff changeset
404 (see below), this will reset the option to the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
405 "opposite" of its default setting and print a mes-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
406 sage describing the new setting. (The "--_X" com-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
407 mand does the same thing as "-_X" on the command
bce86c4163a3 Initial revision
kono
parents:
diff changeset
408 line.) This does not work for numeric or string-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
409 valued options.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
410
bce86c4163a3 Initial revision
kono
parents:
diff changeset
411
bce86c4163a3 Initial revision
kono
parents:
diff changeset
412 _ (Underscore.) Followed by one of the command line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
413 option letters (see below), this will print a mes-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
414 sage describing the current setting of that option.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
415 The setting of the option is not changed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
416
bce86c4163a3 Initial revision
kono
parents:
diff changeset
417
bce86c4163a3 Initial revision
kono
parents:
diff changeset
418 +cmd Causes the specified cmd to be executed each time a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
419 new file is examined. For example, +G causes _l_e_s_s
bce86c4163a3 Initial revision
kono
parents:
diff changeset
420 to initially display each file starting at the end
bce86c4163a3 Initial revision
kono
parents:
diff changeset
421 rather than the beginning.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
422
bce86c4163a3 Initial revision
kono
parents:
diff changeset
423
bce86c4163a3 Initial revision
kono
parents:
diff changeset
424 V Prints the version number of _l_e_s_s being run.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
425
bce86c4163a3 Initial revision
kono
parents:
diff changeset
426
bce86c4163a3 Initial revision
kono
parents:
diff changeset
427 q or :q or :Q or ZZ or ESC ESC
bce86c4163a3 Initial revision
kono
parents:
diff changeset
428 Exits _l_e_s_s_.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
429
bce86c4163a3 Initial revision
kono
parents:
diff changeset
430 The following three commands may or may not be valid,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
431 depending on your particular installation.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
432
bce86c4163a3 Initial revision
kono
parents:
diff changeset
433
bce86c4163a3 Initial revision
kono
parents:
diff changeset
434 v Invokes an editor to edit the current file being
bce86c4163a3 Initial revision
kono
parents:
diff changeset
435 viewed. The editor is taken from the environment
bce86c4163a3 Initial revision
kono
parents:
diff changeset
436 variable EDITOR, or defaults to "vi". See also the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
437 discussion of LESSEDIT under the section on PROMPTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
438 below.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
439
bce86c4163a3 Initial revision
kono
parents:
diff changeset
440
bce86c4163a3 Initial revision
kono
parents:
diff changeset
441 ! shell-command
bce86c4163a3 Initial revision
kono
parents:
diff changeset
442 Invokes a shell to run the shell-command given. A
bce86c4163a3 Initial revision
kono
parents:
diff changeset
443 percent sign (%) in the command is replaced by the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
444 name of the current file. A pound sign (#) is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
445 replaced by the name of the previously examined
bce86c4163a3 Initial revision
kono
parents:
diff changeset
446 file. "!!" repeats the last shell command. "!"
bce86c4163a3 Initial revision
kono
parents:
diff changeset
447 with no shell command simply invokes a shell. In
bce86c4163a3 Initial revision
kono
parents:
diff changeset
448 all cases, the shell is taken from the environment
bce86c4163a3 Initial revision
kono
parents:
diff changeset
449 variable SHELL, or defaults to "sh".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
450
bce86c4163a3 Initial revision
kono
parents:
diff changeset
451
bce86c4163a3 Initial revision
kono
parents:
diff changeset
452 | <m> shell-command
bce86c4163a3 Initial revision
kono
parents:
diff changeset
453 <m> represents any mark letter. Pipes a section of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
454 the input file to the given shell command. The
bce86c4163a3 Initial revision
kono
parents:
diff changeset
455 section of the file to be piped is between the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
456 first line on the current screen and the position
bce86c4163a3 Initial revision
kono
parents:
diff changeset
457
bce86c4163a3 Initial revision
kono
parents:
diff changeset
458
bce86c4163a3 Initial revision
kono
parents:
diff changeset
459
bce86c4163a3 Initial revision
kono
parents:
diff changeset
460 7
bce86c4163a3 Initial revision
kono
parents:
diff changeset
461
bce86c4163a3 Initial revision
kono
parents:
diff changeset
462
bce86c4163a3 Initial revision
kono
parents:
diff changeset
463
bce86c4163a3 Initial revision
kono
parents:
diff changeset
464
bce86c4163a3 Initial revision
kono
parents:
diff changeset
465
bce86c4163a3 Initial revision
kono
parents:
diff changeset
466 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
467
bce86c4163a3 Initial revision
kono
parents:
diff changeset
468
bce86c4163a3 Initial revision
kono
parents:
diff changeset
469 marked by the letter. <m> may also be ^ or $ to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
470 indicate beginning or end of file respectively. If
bce86c4163a3 Initial revision
kono
parents:
diff changeset
471 <m> is . or newline, the current screen is piped.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
472
bce86c4163a3 Initial revision
kono
parents:
diff changeset
473
bce86c4163a3 Initial revision
kono
parents:
diff changeset
474 OOPPTTIIOONNSS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
475 Command line options are described below. Most options
bce86c4163a3 Initial revision
kono
parents:
diff changeset
476 may be changed while _l_e_s_s is running, via the "-" command.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
477
bce86c4163a3 Initial revision
kono
parents:
diff changeset
478 Options are also taken from the environment variable
bce86c4163a3 Initial revision
kono
parents:
diff changeset
479 "LESS". For example, to avoid typing "less -options ..."
bce86c4163a3 Initial revision
kono
parents:
diff changeset
480 each time _l_e_s_s is invoked, you might tell _c_s_h_:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
481
bce86c4163a3 Initial revision
kono
parents:
diff changeset
482 setenv LESS "-options"
bce86c4163a3 Initial revision
kono
parents:
diff changeset
483
bce86c4163a3 Initial revision
kono
parents:
diff changeset
484 or if you use _s_h_:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
485
bce86c4163a3 Initial revision
kono
parents:
diff changeset
486 LESS="-options"; export LESS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
487
bce86c4163a3 Initial revision
kono
parents:
diff changeset
488 The environment variable is parsed before the command
bce86c4163a3 Initial revision
kono
parents:
diff changeset
489 line, so command line options override the LESS environ-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
490 ment variable. If an option appears in the LESS variable,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
491 it can be reset to its default on the command line by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
492 beginning the command line option with "-+".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
493
bce86c4163a3 Initial revision
kono
parents:
diff changeset
494 A dollar sign ($) may be used to signal the end of an
bce86c4163a3 Initial revision
kono
parents:
diff changeset
495 option string. This is important only for options like -P
bce86c4163a3 Initial revision
kono
parents:
diff changeset
496 which take a following string.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
497
bce86c4163a3 Initial revision
kono
parents:
diff changeset
498 -? This option displays a summary of the commands
bce86c4163a3 Initial revision
kono
parents:
diff changeset
499 accepted by _l_e_s_s (the same as the h command). If
bce86c4163a3 Initial revision
kono
parents:
diff changeset
500 this option is given, all other options are
bce86c4163a3 Initial revision
kono
parents:
diff changeset
501 ignored, and _l_e_s_s exits after the help screen is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
502 viewed. (Depending on how your shell interprets
bce86c4163a3 Initial revision
kono
parents:
diff changeset
503 the question mark, it may be necessary to quote the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
504 question mark, thus: "-\?".)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
505
bce86c4163a3 Initial revision
kono
parents:
diff changeset
506 -a Causes searches to start after the last line dis-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
507 played on the screen, thus skipping all lines dis-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
508 played on the screen. By default, searches start
bce86c4163a3 Initial revision
kono
parents:
diff changeset
509 at the second line on the screen (or after the last
bce86c4163a3 Initial revision
kono
parents:
diff changeset
510 found line; see the -j option).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
511
bce86c4163a3 Initial revision
kono
parents:
diff changeset
512 -b_n Causes _l_e_s_s to use a non-standard number of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
513 buffers. Buffers are 1K, and by default 10 buffers
bce86c4163a3 Initial revision
kono
parents:
diff changeset
514 are used (except if data in coming from standard
bce86c4163a3 Initial revision
kono
parents:
diff changeset
515 input; see the -B option). The number _n specifies
bce86c4163a3 Initial revision
kono
parents:
diff changeset
516 a different number of buffers to use.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
517
bce86c4163a3 Initial revision
kono
parents:
diff changeset
518 -B Disables automatic allocation of buffers, so that
bce86c4163a3 Initial revision
kono
parents:
diff changeset
519 only the default number of buffers are used. If
bce86c4163a3 Initial revision
kono
parents:
diff changeset
520 more data is read than will fit in the buffers, the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
521 oldest data is discarded. By default, when data is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
522 coming from standard input, buffers are allocated
bce86c4163a3 Initial revision
kono
parents:
diff changeset
523
bce86c4163a3 Initial revision
kono
parents:
diff changeset
524
bce86c4163a3 Initial revision
kono
parents:
diff changeset
525
bce86c4163a3 Initial revision
kono
parents:
diff changeset
526 8
bce86c4163a3 Initial revision
kono
parents:
diff changeset
527
bce86c4163a3 Initial revision
kono
parents:
diff changeset
528
bce86c4163a3 Initial revision
kono
parents:
diff changeset
529
bce86c4163a3 Initial revision
kono
parents:
diff changeset
530
bce86c4163a3 Initial revision
kono
parents:
diff changeset
531
bce86c4163a3 Initial revision
kono
parents:
diff changeset
532 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
533
bce86c4163a3 Initial revision
kono
parents:
diff changeset
534
bce86c4163a3 Initial revision
kono
parents:
diff changeset
535 automatically as needed to avoid loss of data.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
536
bce86c4163a3 Initial revision
kono
parents:
diff changeset
537 -c Causes full screen repaints to be painted from the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
538 top line down. By default, full screen repaints
bce86c4163a3 Initial revision
kono
parents:
diff changeset
539 are done by scrolling from the bottom of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
540 screen.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
541
bce86c4163a3 Initial revision
kono
parents:
diff changeset
542 -C The -C option is like -c, but the screen is cleared
bce86c4163a3 Initial revision
kono
parents:
diff changeset
543 before it is repainted.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
544
bce86c4163a3 Initial revision
kono
parents:
diff changeset
545 -d The -d option suppresses the error message normally
bce86c4163a3 Initial revision
kono
parents:
diff changeset
546 displayed if the terminal is dumb; that is, lacks
bce86c4163a3 Initial revision
kono
parents:
diff changeset
547 some important capability, such as the ability to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
548 clear the screen or scroll backward. The -d option
bce86c4163a3 Initial revision
kono
parents:
diff changeset
549 does not otherwise change the behavior of _l_e_s_s on a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
550 dumb terminal).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
551
bce86c4163a3 Initial revision
kono
parents:
diff changeset
552 -e Causes _l_e_s_s to automatically exit the second time
bce86c4163a3 Initial revision
kono
parents:
diff changeset
553 it reaches end-of-file. By default, the only way
bce86c4163a3 Initial revision
kono
parents:
diff changeset
554 to exit _l_e_s_s is via the "q" command.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
555
bce86c4163a3 Initial revision
kono
parents:
diff changeset
556 -E Causes _l_e_s_s to automatically exit the first time it
bce86c4163a3 Initial revision
kono
parents:
diff changeset
557 reaches end-of-file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
558
bce86c4163a3 Initial revision
kono
parents:
diff changeset
559 -f Forces non-regular files to be opened. (A non-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
560 regular file is a directory or a device special
bce86c4163a3 Initial revision
kono
parents:
diff changeset
561 file.) Also suppresses the warning message when a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
562 binary file is opened. By default, _l_e_s_s will
bce86c4163a3 Initial revision
kono
parents:
diff changeset
563 refuse to open non-regular files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
564
bce86c4163a3 Initial revision
kono
parents:
diff changeset
565 -h_n Specifies a maximum number of lines to scroll back-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
566 ward. If it is necessary to scroll backward more
bce86c4163a3 Initial revision
kono
parents:
diff changeset
567 than _n lines, the screen is repainted in a forward
bce86c4163a3 Initial revision
kono
parents:
diff changeset
568 direction instead. (If the terminal does not have
bce86c4163a3 Initial revision
kono
parents:
diff changeset
569 the ability to scroll backward, -h0 is implied.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
570
bce86c4163a3 Initial revision
kono
parents:
diff changeset
571 -i Causes searches to ignore case; that is, uppercase
bce86c4163a3 Initial revision
kono
parents:
diff changeset
572 and lowercase are considered identical. Also, text
bce86c4163a3 Initial revision
kono
parents:
diff changeset
573 which is overstruck or underlined can be searched
bce86c4163a3 Initial revision
kono
parents:
diff changeset
574 for. This option is ignored if any uppercase let-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
575 ters appear in the search pattern.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
576
bce86c4163a3 Initial revision
kono
parents:
diff changeset
577 -j_n Specifies a line on the screen where "target" lines
bce86c4163a3 Initial revision
kono
parents:
diff changeset
578 are to be positioned. Target lines are the object
bce86c4163a3 Initial revision
kono
parents:
diff changeset
579 of text searches, tag searches, jumps to a line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
580 number, jumps to a file percentage, and jumps to a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
581 marked position. The screen line is specified by a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
582 number: the top line on the screen is 1, the next
bce86c4163a3 Initial revision
kono
parents:
diff changeset
583 is 2, and so on. The number may be negative to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
584 specify a line relative to the bottom of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
585 screen: the bottom line on the screen is -1, the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
586 second to the bottom is -2, and so on. If the -j
bce86c4163a3 Initial revision
kono
parents:
diff changeset
587 option is used, searches begin at the line immedi-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
588 ately after the target line. For example, if "-j4"
bce86c4163a3 Initial revision
kono
parents:
diff changeset
589
bce86c4163a3 Initial revision
kono
parents:
diff changeset
590
bce86c4163a3 Initial revision
kono
parents:
diff changeset
591
bce86c4163a3 Initial revision
kono
parents:
diff changeset
592 9
bce86c4163a3 Initial revision
kono
parents:
diff changeset
593
bce86c4163a3 Initial revision
kono
parents:
diff changeset
594
bce86c4163a3 Initial revision
kono
parents:
diff changeset
595
bce86c4163a3 Initial revision
kono
parents:
diff changeset
596
bce86c4163a3 Initial revision
kono
parents:
diff changeset
597
bce86c4163a3 Initial revision
kono
parents:
diff changeset
598 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
599
bce86c4163a3 Initial revision
kono
parents:
diff changeset
600
bce86c4163a3 Initial revision
kono
parents:
diff changeset
601 is used, the target line is the fourth line on the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
602 screen, so searches begin at the fifth line on the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
603 screen.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
604
bce86c4163a3 Initial revision
kono
parents:
diff changeset
605 -k_f_i_l_e_n_a_m_e
bce86c4163a3 Initial revision
kono
parents:
diff changeset
606 Causes _l_e_s_s to open and interpret the named file as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
607 a _l_e_s_s_k_e_y (1) file. Multiple -k options may be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
608 specified. If a file called .less exists in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
609 user's home directory, this file is also used as a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
610 _l_e_s_s_k_e_y file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
611
bce86c4163a3 Initial revision
kono
parents:
diff changeset
612 -m Causes _l_e_s_s to prompt verbosely (like _m_o_r_e), with
bce86c4163a3 Initial revision
kono
parents:
diff changeset
613 the percent into the file. By default, _l_e_s_s
bce86c4163a3 Initial revision
kono
parents:
diff changeset
614 prompts with a colon.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
615
bce86c4163a3 Initial revision
kono
parents:
diff changeset
616 -M Causes _l_e_s_s to prompt even more verbosely than
bce86c4163a3 Initial revision
kono
parents:
diff changeset
617 _m_o_r_e_.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
618
bce86c4163a3 Initial revision
kono
parents:
diff changeset
619 -n Suppresses line numbers. The default (to use line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
620 numbers) may cause _l_e_s_s to run more slowly in some
bce86c4163a3 Initial revision
kono
parents:
diff changeset
621 cases, especially with a very large input file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
622 Suppressing line numbers with the -n flag will
bce86c4163a3 Initial revision
kono
parents:
diff changeset
623 avoid this problem. Using line numbers means: the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
624 line number will be displayed in the verbose prompt
bce86c4163a3 Initial revision
kono
parents:
diff changeset
625 and in the = command, and the v command will pass
bce86c4163a3 Initial revision
kono
parents:
diff changeset
626 the current line number to the editor (see also the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
627 discussion of LESSEDIT in PROMPTS below).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
628
bce86c4163a3 Initial revision
kono
parents:
diff changeset
629 -N Causes a line number to be displayed at the begin-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
630 ning of each line in the display.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
631
bce86c4163a3 Initial revision
kono
parents:
diff changeset
632 -o_f_i_l_e_n_a_m_e
bce86c4163a3 Initial revision
kono
parents:
diff changeset
633 Causes _l_e_s_s to copy its input to the named file as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
634 it is being viewed. This applies only when the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
635 input file is a pipe, not an ordinary file. If the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
636 file already exists, _l_e_s_s will ask for confirmation
bce86c4163a3 Initial revision
kono
parents:
diff changeset
637 before overwriting it.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
638
bce86c4163a3 Initial revision
kono
parents:
diff changeset
639 -O_f_i_l_e_n_a_m_e
bce86c4163a3 Initial revision
kono
parents:
diff changeset
640 The -O option is like -o, but it will overwrite an
bce86c4163a3 Initial revision
kono
parents:
diff changeset
641 existing file without asking for confirmation.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
642
bce86c4163a3 Initial revision
kono
parents:
diff changeset
643 If no log file has been specified, the -o and -O
bce86c4163a3 Initial revision
kono
parents:
diff changeset
644 options can be used from within _l_e_s_s to specify a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
645 log file. Without a file name, they will simply
bce86c4163a3 Initial revision
kono
parents:
diff changeset
646 report the name of the log file. The "s" command
bce86c4163a3 Initial revision
kono
parents:
diff changeset
647 is equivalent to specifying -o from within _l_e_s_s_.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
648
bce86c4163a3 Initial revision
kono
parents:
diff changeset
649 -p_p_a_t_t_e_r_n
bce86c4163a3 Initial revision
kono
parents:
diff changeset
650 The -p option on the command line is equivalent to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
651 specifying +/_p_a_t_t_e_r_n; that is, it tells _l_e_s_s to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
652 start at the first occurence of _p_a_t_t_e_r_n in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
653 file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
654
bce86c4163a3 Initial revision
kono
parents:
diff changeset
655
bce86c4163a3 Initial revision
kono
parents:
diff changeset
656
bce86c4163a3 Initial revision
kono
parents:
diff changeset
657
bce86c4163a3 Initial revision
kono
parents:
diff changeset
658 10
bce86c4163a3 Initial revision
kono
parents:
diff changeset
659
bce86c4163a3 Initial revision
kono
parents:
diff changeset
660
bce86c4163a3 Initial revision
kono
parents:
diff changeset
661
bce86c4163a3 Initial revision
kono
parents:
diff changeset
662
bce86c4163a3 Initial revision
kono
parents:
diff changeset
663
bce86c4163a3 Initial revision
kono
parents:
diff changeset
664 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
665
bce86c4163a3 Initial revision
kono
parents:
diff changeset
666
bce86c4163a3 Initial revision
kono
parents:
diff changeset
667 -P_p_r_o_m_p_t
bce86c4163a3 Initial revision
kono
parents:
diff changeset
668 Provides a way to tailor the three prompt styles to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
669 your own preference. This option would normally be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
670 put in the LESS environment variable, rather than
bce86c4163a3 Initial revision
kono
parents:
diff changeset
671 being typed in with each _l_e_s_s command. Such an
bce86c4163a3 Initial revision
kono
parents:
diff changeset
672 option must either be the last option in the LESS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
673 variable, or be terminated by a dollar sign. -P
bce86c4163a3 Initial revision
kono
parents:
diff changeset
674 followed by a string changes the default (short)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
675 prompt to that string. -Pm changes the medium (-m)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
676 prompt to the string, and -PM changes the long (-M)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
677 prompt. Also, -P= changes the message printed by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
678 the = command to the given string. All prompt
bce86c4163a3 Initial revision
kono
parents:
diff changeset
679 strings consist of a sequence of letters and spe-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
680 cial escape sequences. See the section on PROMPTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
681 for more details.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
682
bce86c4163a3 Initial revision
kono
parents:
diff changeset
683 -q Causes moderately "quiet" operation: the terminal
bce86c4163a3 Initial revision
kono
parents:
diff changeset
684 bell is not rung if an attempt is made to scroll
bce86c4163a3 Initial revision
kono
parents:
diff changeset
685 past the end of the file or before the beginning of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
686 the file. If the terminal has a "visual bell", it
bce86c4163a3 Initial revision
kono
parents:
diff changeset
687 is used instead. The bell will be rung on certain
bce86c4163a3 Initial revision
kono
parents:
diff changeset
688 other errors, such as typing an invalid character.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
689 The default is to ring the terminal bell in all
bce86c4163a3 Initial revision
kono
parents:
diff changeset
690 such cases.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
691
bce86c4163a3 Initial revision
kono
parents:
diff changeset
692 -Q Causes totally "quiet" operation: the terminal bell
bce86c4163a3 Initial revision
kono
parents:
diff changeset
693 is never rung.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
694
bce86c4163a3 Initial revision
kono
parents:
diff changeset
695 -r Causes "raw" control characters to be displayed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
696 The default is to display control characters using
bce86c4163a3 Initial revision
kono
parents:
diff changeset
697 the caret notation; for example, a control-A (octal
bce86c4163a3 Initial revision
kono
parents:
diff changeset
698 001) is displayed as "^A". Warning: when the -r
bce86c4163a3 Initial revision
kono
parents:
diff changeset
699 flag is used, _l_e_s_s cannot keep track of the actual
bce86c4163a3 Initial revision
kono
parents:
diff changeset
700 appearance of the screen (since this depends on how
bce86c4163a3 Initial revision
kono
parents:
diff changeset
701 the screen responds to each type of control charac-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
702 ter). Thus, various display problems may result,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
703 such as long lines being split in the wrong place.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
704
bce86c4163a3 Initial revision
kono
parents:
diff changeset
705 -s Causes consecutive blank lines to be squeezed into
bce86c4163a3 Initial revision
kono
parents:
diff changeset
706 a single blank line. This is useful when viewing
bce86c4163a3 Initial revision
kono
parents:
diff changeset
707 _n_r_o_f_f output.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
708
bce86c4163a3 Initial revision
kono
parents:
diff changeset
709 -S Causes lines longer than the screen width to be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
710 chopped rather than folded. That is, the remainder
bce86c4163a3 Initial revision
kono
parents:
diff changeset
711 of a long line is simply discarded. The default is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
712 to fold long lines; that is, display the remainder
bce86c4163a3 Initial revision
kono
parents:
diff changeset
713 on the next line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
714
bce86c4163a3 Initial revision
kono
parents:
diff changeset
715 -t_t_a_g The -t option, followed immediately by a TAG, will
bce86c4163a3 Initial revision
kono
parents:
diff changeset
716 edit the file containing that tag. For this to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
717 work, there must be a file called "tags" in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
718 current directory, which was previously built by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
719 the _c_t_a_g_s (1) command. This option may also be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
720 specified from within _l_e_s_s (using the - command) as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
721
bce86c4163a3 Initial revision
kono
parents:
diff changeset
722
bce86c4163a3 Initial revision
kono
parents:
diff changeset
723
bce86c4163a3 Initial revision
kono
parents:
diff changeset
724 11
bce86c4163a3 Initial revision
kono
parents:
diff changeset
725
bce86c4163a3 Initial revision
kono
parents:
diff changeset
726
bce86c4163a3 Initial revision
kono
parents:
diff changeset
727
bce86c4163a3 Initial revision
kono
parents:
diff changeset
728
bce86c4163a3 Initial revision
kono
parents:
diff changeset
729
bce86c4163a3 Initial revision
kono
parents:
diff changeset
730 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
731
bce86c4163a3 Initial revision
kono
parents:
diff changeset
732
bce86c4163a3 Initial revision
kono
parents:
diff changeset
733 a way of examining a new file. The command ":t" is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
734 equivalent to specifying -t from within _l_e_s_s_.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
735
bce86c4163a3 Initial revision
kono
parents:
diff changeset
736 -T_t_a_g_s_f_i_l_e
bce86c4163a3 Initial revision
kono
parents:
diff changeset
737 Specifies a tags file to be used instead of "tags".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
738
bce86c4163a3 Initial revision
kono
parents:
diff changeset
739 -u Causes backspaces and carriage returns to be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
740 treated as printable characters; that is, they are
bce86c4163a3 Initial revision
kono
parents:
diff changeset
741 sent to the terminal when they appear in the input.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
742
bce86c4163a3 Initial revision
kono
parents:
diff changeset
743 -U Causes backspaces and carriage returns to be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
744 treated as control characters; that is, they are
bce86c4163a3 Initial revision
kono
parents:
diff changeset
745 handled as specified by the -r option.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
746
bce86c4163a3 Initial revision
kono
parents:
diff changeset
747 By default, if neither -u nor -U is given,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
748 backspaces which appear adjacent to an underscore
bce86c4163a3 Initial revision
kono
parents:
diff changeset
749 character are treated specially: the underlined
bce86c4163a3 Initial revision
kono
parents:
diff changeset
750 text is displayed using the terminal's hardware
bce86c4163a3 Initial revision
kono
parents:
diff changeset
751 underlining capability. Also, backspaces which
bce86c4163a3 Initial revision
kono
parents:
diff changeset
752 appear between two identical characters are treated
bce86c4163a3 Initial revision
kono
parents:
diff changeset
753 specially: the overstruck text is printed using the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
754 terminal's hardware boldface capability. Other
bce86c4163a3 Initial revision
kono
parents:
diff changeset
755 backspaces are deleted, along with the preceding
bce86c4163a3 Initial revision
kono
parents:
diff changeset
756 character. Carriage returns immediately followed
bce86c4163a3 Initial revision
kono
parents:
diff changeset
757 by a newline are deleted. Other carriage returns
bce86c4163a3 Initial revision
kono
parents:
diff changeset
758 are handled as specified by the -r option.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
759
bce86c4163a3 Initial revision
kono
parents:
diff changeset
760 -w Causes blank lines to be used to represent lines
bce86c4163a3 Initial revision
kono
parents:
diff changeset
761 past the end of the file. By default, a tilde
bce86c4163a3 Initial revision
kono
parents:
diff changeset
762 character is used.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
763
bce86c4163a3 Initial revision
kono
parents:
diff changeset
764 -x_n Sets tab stops every _n positions. The default for
bce86c4163a3 Initial revision
kono
parents:
diff changeset
765 _n is 8.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
766
bce86c4163a3 Initial revision
kono
parents:
diff changeset
767 -y_n Specifies a maximum number of lines to scroll for-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
768 ward. If it is necessary to scroll forward more
bce86c4163a3 Initial revision
kono
parents:
diff changeset
769 than _n lines, the screen is repainted instead. The
bce86c4163a3 Initial revision
kono
parents:
diff changeset
770 -c or -C option may be used to repaint from the top
bce86c4163a3 Initial revision
kono
parents:
diff changeset
771 of the screen if desired. By default, any forward
bce86c4163a3 Initial revision
kono
parents:
diff changeset
772 movement causes scrolling.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
773
bce86c4163a3 Initial revision
kono
parents:
diff changeset
774 -[z]_n Changes the default scrolling window size to _n
bce86c4163a3 Initial revision
kono
parents:
diff changeset
775 lines. The default is one screenful. The z and w
bce86c4163a3 Initial revision
kono
parents:
diff changeset
776 commands can also be used to change the window
bce86c4163a3 Initial revision
kono
parents:
diff changeset
777 size. The "z" may be omitted, as in "-_n" for com-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
778 patibility with _m_o_r_e_.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
779
bce86c4163a3 Initial revision
kono
parents:
diff changeset
780 + If a command line option begins with ++, the remain-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
781 der of that option is taken to be an initial com-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
782 mand to _l_e_s_s_. For example, +G tells _l_e_s_s to start
bce86c4163a3 Initial revision
kono
parents:
diff changeset
783 at the end of the file rather than the beginning,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
784 and +/xyz tells it to start at the first occurrence
bce86c4163a3 Initial revision
kono
parents:
diff changeset
785 of "xyz" in the file. As a special case, +<number>
bce86c4163a3 Initial revision
kono
parents:
diff changeset
786 acts like +<number>g; that is, it starts the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
787
bce86c4163a3 Initial revision
kono
parents:
diff changeset
788
bce86c4163a3 Initial revision
kono
parents:
diff changeset
789
bce86c4163a3 Initial revision
kono
parents:
diff changeset
790 12
bce86c4163a3 Initial revision
kono
parents:
diff changeset
791
bce86c4163a3 Initial revision
kono
parents:
diff changeset
792
bce86c4163a3 Initial revision
kono
parents:
diff changeset
793
bce86c4163a3 Initial revision
kono
parents:
diff changeset
794
bce86c4163a3 Initial revision
kono
parents:
diff changeset
795
bce86c4163a3 Initial revision
kono
parents:
diff changeset
796 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
797
bce86c4163a3 Initial revision
kono
parents:
diff changeset
798
bce86c4163a3 Initial revision
kono
parents:
diff changeset
799 display at the specified line number (however, see
bce86c4163a3 Initial revision
kono
parents:
diff changeset
800 the caveat under the "g" command above). If the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
801 option starts with ++, the initial command applies
bce86c4163a3 Initial revision
kono
parents:
diff changeset
802 to every file being viewed, not just the first one.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
803 The + command described previously may also be used
bce86c4163a3 Initial revision
kono
parents:
diff changeset
804 to set (or change) an initial command for every
bce86c4163a3 Initial revision
kono
parents:
diff changeset
805 file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
806
bce86c4163a3 Initial revision
kono
parents:
diff changeset
807
bce86c4163a3 Initial revision
kono
parents:
diff changeset
808 KKEEYY BBIINNDDIINNGGSS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
809 You may define your own _l_e_s_s commands by using the program
bce86c4163a3 Initial revision
kono
parents:
diff changeset
810 _l_e_s_s_k_e_y (1) to create a file called ".less" in your home
bce86c4163a3 Initial revision
kono
parents:
diff changeset
811 directory. This file specifies a set of command keys and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
812 an action associated with each key. See the _l_e_s_s_k_e_y man-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
813 ual page for more details.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
814
bce86c4163a3 Initial revision
kono
parents:
diff changeset
815
bce86c4163a3 Initial revision
kono
parents:
diff changeset
816 NNAATTIIOONNAALL CCHHAARRAACCTTEERR SSEETTSS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
817 There are three types of characters in the input file:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
818
bce86c4163a3 Initial revision
kono
parents:
diff changeset
819 normal characters
bce86c4163a3 Initial revision
kono
parents:
diff changeset
820 can be displayed directly to the screen.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
821
bce86c4163a3 Initial revision
kono
parents:
diff changeset
822 control characters
bce86c4163a3 Initial revision
kono
parents:
diff changeset
823 should not be displayed directly, but are expected
bce86c4163a3 Initial revision
kono
parents:
diff changeset
824 to be found in ordinary text files (such as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
825 backspace and tab).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
826
bce86c4163a3 Initial revision
kono
parents:
diff changeset
827 binary characters
bce86c4163a3 Initial revision
kono
parents:
diff changeset
828 cannot be displayed directly and are not expected
bce86c4163a3 Initial revision
kono
parents:
diff changeset
829 to be found in text files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
830
bce86c4163a3 Initial revision
kono
parents:
diff changeset
831 By default, _l_e_s_s uses the ASCII character set. In the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
832 ASCII character set, characters with values between 128
bce86c4163a3 Initial revision
kono
parents:
diff changeset
833 and 255 are treated as binary. The LESSCHARSET environ-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
834 ment variable may be used to select another character set.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
835 If it is set to the value "latin1", the ISO 8859/1 charac-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
836 ter set is assumed. Latin-1 is the same as ASCII, except
bce86c4163a3 Initial revision
kono
parents:
diff changeset
837 characters between 128 and 255 are treated as normal char-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
838 acters. The only valid values for LESSCHARSET currently
bce86c4163a3 Initial revision
kono
parents:
diff changeset
839 are "ascii" and "latin1".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
840
bce86c4163a3 Initial revision
kono
parents:
diff changeset
841 In special cases, it may be desired to tailor _l_e_s_s to use
bce86c4163a3 Initial revision
kono
parents:
diff changeset
842 a character set other than the ones definable by LESS-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
843 CHARSET. In this case, the environment variable LESS-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
844 CHARDEF can be used to define a character set. It should
bce86c4163a3 Initial revision
kono
parents:
diff changeset
845 be set to a string where each character in the string rep-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
846 resents one character in the character set. The character
bce86c4163a3 Initial revision
kono
parents:
diff changeset
847 "." is used for a normal character, "c" for control, and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
848 "b" for binary. A decimal number may be used for repeti-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
849 tion. For example, "bccc4b." would mean character 0 is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
850 binary, 1, 2 and 3 are control, 4, 5, 6 and 7 are binary,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
851 and 8 is normal. All characters after the last are taken
bce86c4163a3 Initial revision
kono
parents:
diff changeset
852 to be the same as the last, so characters 9 through 255
bce86c4163a3 Initial revision
kono
parents:
diff changeset
853
bce86c4163a3 Initial revision
kono
parents:
diff changeset
854
bce86c4163a3 Initial revision
kono
parents:
diff changeset
855
bce86c4163a3 Initial revision
kono
parents:
diff changeset
856 13
bce86c4163a3 Initial revision
kono
parents:
diff changeset
857
bce86c4163a3 Initial revision
kono
parents:
diff changeset
858
bce86c4163a3 Initial revision
kono
parents:
diff changeset
859
bce86c4163a3 Initial revision
kono
parents:
diff changeset
860
bce86c4163a3 Initial revision
kono
parents:
diff changeset
861
bce86c4163a3 Initial revision
kono
parents:
diff changeset
862 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
863
bce86c4163a3 Initial revision
kono
parents:
diff changeset
864
bce86c4163a3 Initial revision
kono
parents:
diff changeset
865 would be normal. (This is an example, and does not neces-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
866 sarily represent any real character set.)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
867
bce86c4163a3 Initial revision
kono
parents:
diff changeset
868 Setting LESSCHARDEF to "8bcccbcc18b95.b" is the same as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
869 setting LESSCHARSET to "ascii". Setting LESSCHARDEF to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
870 "8bcccbcc18b95.33b." is the same as setting LESSCHARSET to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
871 "latin1".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
872
bce86c4163a3 Initial revision
kono
parents:
diff changeset
873 Control and binary characters are displayed in blinking
bce86c4163a3 Initial revision
kono
parents:
diff changeset
874 mode. Each such character is displayed in caret notation
bce86c4163a3 Initial revision
kono
parents:
diff changeset
875 if possible (e.g. ^A for control-A). Caret notation is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
876 used only if inverting the 0100 bit results in a normal
bce86c4163a3 Initial revision
kono
parents:
diff changeset
877 printable character. Otherwise, the character is dis-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
878 played as an octal number preceded by a backslash. This
bce86c4163a3 Initial revision
kono
parents:
diff changeset
879 octal format can be changed by setting the LESSBINFMT
bce86c4163a3 Initial revision
kono
parents:
diff changeset
880 environment variable to a printf-style format string; the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
881 default is '\%o'. The blinking mode display of control
bce86c4163a3 Initial revision
kono
parents:
diff changeset
882 and binary characters can be changed or disabled by pre-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
883 ceding the LESSBINFMT format string with a "*" and one
bce86c4163a3 Initial revision
kono
parents:
diff changeset
884 character to select the mode: "*k" is blinking, "*d" is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
885 bold, "*u" is underlined, and "*n" is normal (no special
bce86c4163a3 Initial revision
kono
parents:
diff changeset
886 display attribute). For example, if LESSBINFMT is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
887 "*u[%x]", binary characters are displayed in underlined
bce86c4163a3 Initial revision
kono
parents:
diff changeset
888 hexadecimal surrounded by brackets.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
889
bce86c4163a3 Initial revision
kono
parents:
diff changeset
890
bce86c4163a3 Initial revision
kono
parents:
diff changeset
891 PPRROOMMPPTTSS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
892 The -P option allows you to tailor the prompt to your
bce86c4163a3 Initial revision
kono
parents:
diff changeset
893 preference. The string given to the -P option replaces
bce86c4163a3 Initial revision
kono
parents:
diff changeset
894 the specified prompt string. Certain characters in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
895 string are interpreted specially. The prompt mechanism is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
896 rather complicated to provide flexibility, but the ordi-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
897 nary user need not understand the details of constructing
bce86c4163a3 Initial revision
kono
parents:
diff changeset
898 personalized prompt strings.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
899
bce86c4163a3 Initial revision
kono
parents:
diff changeset
900 A percent sign followed by a single character is expanded
bce86c4163a3 Initial revision
kono
parents:
diff changeset
901 according to what the following character is:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
902
bce86c4163a3 Initial revision
kono
parents:
diff changeset
903 %b_X Replaced by the byte offset into the current input
bce86c4163a3 Initial revision
kono
parents:
diff changeset
904 file. The b is followed by a single character
bce86c4163a3 Initial revision
kono
parents:
diff changeset
905 (shown as _X above) which specifies the line whose
bce86c4163a3 Initial revision
kono
parents:
diff changeset
906 byte offset is to be used. If the character is a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
907 "t", the byte offset of the top line in the display
bce86c4163a3 Initial revision
kono
parents:
diff changeset
908 is used, an "m" means use the middle line, a "b"
bce86c4163a3 Initial revision
kono
parents:
diff changeset
909 means use the bottom line, a "B" means use the line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
910 just after the bottom line, and a "j" means use the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
911 "target" line, as specified by the -j option.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
912
bce86c4163a3 Initial revision
kono
parents:
diff changeset
913 %B Replaced by the size of the current input file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
914
bce86c4163a3 Initial revision
kono
parents:
diff changeset
915 %E Replaced by the name of the editor (from the EDITOR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
916 environment variable). See the discussion of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
917 LESSEDIT feature below.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
918
bce86c4163a3 Initial revision
kono
parents:
diff changeset
919
bce86c4163a3 Initial revision
kono
parents:
diff changeset
920
bce86c4163a3 Initial revision
kono
parents:
diff changeset
921
bce86c4163a3 Initial revision
kono
parents:
diff changeset
922 14
bce86c4163a3 Initial revision
kono
parents:
diff changeset
923
bce86c4163a3 Initial revision
kono
parents:
diff changeset
924
bce86c4163a3 Initial revision
kono
parents:
diff changeset
925
bce86c4163a3 Initial revision
kono
parents:
diff changeset
926
bce86c4163a3 Initial revision
kono
parents:
diff changeset
927
bce86c4163a3 Initial revision
kono
parents:
diff changeset
928 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
929
bce86c4163a3 Initial revision
kono
parents:
diff changeset
930
bce86c4163a3 Initial revision
kono
parents:
diff changeset
931 %f Replaced by the name of the current input file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
932
bce86c4163a3 Initial revision
kono
parents:
diff changeset
933 %i Replaced by the index of the current file in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
934 list of input files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
935
bce86c4163a3 Initial revision
kono
parents:
diff changeset
936 %l_X Replaced by the line number of a line in the input
bce86c4163a3 Initial revision
kono
parents:
diff changeset
937 file. The line to be used is determined by the _X,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
938 as with the %b option.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
939
bce86c4163a3 Initial revision
kono
parents:
diff changeset
940 %L Replaced by the line number of the last line in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
941 input file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
942
bce86c4163a3 Initial revision
kono
parents:
diff changeset
943 %m Replaced by the total number of input files.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
944
bce86c4163a3 Initial revision
kono
parents:
diff changeset
945 %p_X Replaced by the percent into the current input
bce86c4163a3 Initial revision
kono
parents:
diff changeset
946 file. The line used is determined by the _X as with
bce86c4163a3 Initial revision
kono
parents:
diff changeset
947 the %b option.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
948
bce86c4163a3 Initial revision
kono
parents:
diff changeset
949 %s Same as %B.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
950
bce86c4163a3 Initial revision
kono
parents:
diff changeset
951 %t Causes any trailing spaces to be removed. Usually
bce86c4163a3 Initial revision
kono
parents:
diff changeset
952 used at the end of the string, but may appear any-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
953 where.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
954
bce86c4163a3 Initial revision
kono
parents:
diff changeset
955 %x Replaced by the name of the next input file in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
956 list.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
957
bce86c4163a3 Initial revision
kono
parents:
diff changeset
958 If any item is unknown (for example, the file size if
bce86c4163a3 Initial revision
kono
parents:
diff changeset
959 input is a pipe), a question mark is printed instead.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
960
bce86c4163a3 Initial revision
kono
parents:
diff changeset
961 The format of the prompt string can be changed depending
bce86c4163a3 Initial revision
kono
parents:
diff changeset
962 on certain conditions. A question mark followed by a sin-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
963 gle character acts like an "IF": depending on the follow-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
964 ing character, a condition is evaluated. If the condition
bce86c4163a3 Initial revision
kono
parents:
diff changeset
965 is true, any characters following the question mark and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
966 condition character, up to a period, are included in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
967 prompt. If the condition is false, such characters are
bce86c4163a3 Initial revision
kono
parents:
diff changeset
968 not included. A colon appearing between the question mark
bce86c4163a3 Initial revision
kono
parents:
diff changeset
969 and the period can be used to establish an "ELSE": any
bce86c4163a3 Initial revision
kono
parents:
diff changeset
970 characters between the colon and the period are included
bce86c4163a3 Initial revision
kono
parents:
diff changeset
971 in the string if and only if the IF condition is false.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
972 Condition characters (which follow a question mark) may
bce86c4163a3 Initial revision
kono
parents:
diff changeset
973 be:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
974
bce86c4163a3 Initial revision
kono
parents:
diff changeset
975 ?a True if any characters have been included in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
976 prompt so far.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
977
bce86c4163a3 Initial revision
kono
parents:
diff changeset
978 ?b_X True if the byte offset of the specified line is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
979 known.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
980
bce86c4163a3 Initial revision
kono
parents:
diff changeset
981 ?B True if the size of current input file is known.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
982
bce86c4163a3 Initial revision
kono
parents:
diff changeset
983 ?e True if at end-of-file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
984
bce86c4163a3 Initial revision
kono
parents:
diff changeset
985
bce86c4163a3 Initial revision
kono
parents:
diff changeset
986
bce86c4163a3 Initial revision
kono
parents:
diff changeset
987
bce86c4163a3 Initial revision
kono
parents:
diff changeset
988 15
bce86c4163a3 Initial revision
kono
parents:
diff changeset
989
bce86c4163a3 Initial revision
kono
parents:
diff changeset
990
bce86c4163a3 Initial revision
kono
parents:
diff changeset
991
bce86c4163a3 Initial revision
kono
parents:
diff changeset
992
bce86c4163a3 Initial revision
kono
parents:
diff changeset
993
bce86c4163a3 Initial revision
kono
parents:
diff changeset
994 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
995
bce86c4163a3 Initial revision
kono
parents:
diff changeset
996
bce86c4163a3 Initial revision
kono
parents:
diff changeset
997 ?f True if there is an input filename (that is, if
bce86c4163a3 Initial revision
kono
parents:
diff changeset
998 input is not a pipe).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
999
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1000 ?l_X True if the line number of the specified line is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1001 known.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1002
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1003 ?L True if the line number of the last line in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1004 file is known.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1005
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1006 ?m True if there is more than one input file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1007
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1008 ?n True if this is the first prompt in a new input
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1009 file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1010
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1011 ?p_X True if the percent into the current input file of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1012 the specified line is known.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1013
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1014 ?s Same as "?B".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1015
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1016 ?x True if there is a next input file (that is, if the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1017 current input file is not the last one).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1018
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1019 Any characters other than the special ones (question mark,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1020 colon, period, percent, and backslash) become literally
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1021 part of the prompt. Any of the special characters may be
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1022 included in the prompt literally by preceding it with a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1023 backslash.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1024
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1025 Some examples:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1026
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1027 ?f%f:Standard input.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1028
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1029 This prompt prints the filename, if known; otherwise the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1030 string "Standard input".
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1031
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1032 ?f%f .?ltLine %lt:?pt%pt\%:?btByte %bt:-...
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1033
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1034 This prompt would print the filename, if known. The file-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1035 name is followed by the line number, if known, otherwise
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1036 the percent if known, otherwise the byte offset if known.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1037 Otherwise, a dash is printed. Notice how each question
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1038 mark has a matching period, and how the % after the %pt is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1039 included literally by escaping it with a backslash.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1040
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1041 ?n?f%f .?m(file %i of %m) ..?e(END) ?x- Next\: %x..%t
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1042
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1043 This prints the filename if this is the first prompt in a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1044 file, followed by the "file N of N" message if there is
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1045 more than one input file. Then, if we are at end-of-file,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1046 the string "(END)" is printed followed by the name of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1047 next file, if there is one. Finally, any trailing spaces
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1048 are truncated. This is the default prompt. For refer-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1049 ence, here are the defaults for the other two prompts (-m
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1050 and -M respectively). Each is broken into two lines here
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1051
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1052
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1053
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1054 16
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1055
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1056
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1057
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1058
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1059
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1060 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1061
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1062
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1063 for readability only.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1064
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1065 ?n?f%f .?m(file %i of %m) ..?e(END) ?x- Next\: %x.:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1066 ?pB%pB\%:byte %bB?s/%s...%t
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1067
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1068 ?f%f .?n?m(file %i of %m) ..?ltline %lt?L/%L. :byte %bB?s/%s. .
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1069 ?e(END) ?x- Next\: %x.:?pB%pB\%..%t
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1070
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1071 And here is the default message produced by the = command:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1072
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1073 ?f%f .?m(file %i of %m) .?ltline %lt?L/%L. .
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1074 byte %bB?s/%s. ?e(END) :?pB%pB\%..%t
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1075
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1076 The prompt expansion features are also used for another
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1077 purpose: if an environment variable LESSEDIT is defined,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1078 it is used as the command to be executed when the v com-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1079 mand is invoked. The LESSEDIT string is expanded in the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1080 same way as the prompt strings. The default value for
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1081 LESSEDIT is:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1082
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1083 %E ?lm+%lm. %f
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1084
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1085 Note that this expands to the editor name, followed by a +
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1086 and the line number, followed by the file name. If your
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1087 editor does not accept the "+linenumber" syntax, or has
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1088 other differences in invocation syntax, the LESSEDIT vari-
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1089 able can be changed to modify this default.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1090
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1091
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1092 EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1093 COLUMNS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1094 Sets the number of columns on the screen. Takes
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1095 precedence over the number of columns specified by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1096 the TERM variable.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1097
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1098 EDITOR The name of the editor (used for the v command).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1099
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1100 HOME Name of the user's home directory (used to find a
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1101 .less file).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1102
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1103 LESS Flags which are passed to _l_e_s_s automatically.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1104
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1105 LESSBINFMT
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1106 Format for displaying non-printable, non-control
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1107 characters.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1108
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1109 LESSCHARDEF
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1110 Defines a character set.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1111
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1112 LESSCHARSET
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1113 Selects a predefined character set.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1114
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1115 LESSEDIT
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1116 Editor prototype string (used for the v command).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1117
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1118
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1119
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1120 17
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1121
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1122
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1123
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1124
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1125
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1126 LESS(1) LESS(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1127
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1128
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1129 See discussion under PROMPTS.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1130
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1131 LESSHELP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1132 Name of the help file.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1133
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1134 LINES Sets the number of lines on the screen. Takes
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1135 precedence over the number of lines specified by
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1136 the TERM variable.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1137
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1138 SHELL The shell used to execute the ! command, as well as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1139 to expand filenames.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1140
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1141 TERM The type of terminal on which _l_e_s_s is being run.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1142
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1143
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1144 SSEEEE AALLSSOO
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1145 lesskey(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1146
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1147
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1148 WWAARRNNIINNGGSS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1149 The = command and prompts (unless changed by -P) report
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1150 the line number of the line at the top of the screen, but
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1151 the byte and percent of the line at the bottom of the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1152 screen.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1153
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1154 If the :e command is used to name more than one file, and
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1155 one of the named files has been viewed previously, the new
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1156 files may be entered into the list in an unexpected order.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1157
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1158 The handling of national character sets is nonstandard as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1159 well as insufficient for multibyte characters. It will
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1160 probably change in a later release.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1161
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1162
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1163
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1164
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1165
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1166
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1167
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1168
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1169
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1170
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1171
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1172
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1173
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1174
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1175
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1176
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1177
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1178
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1179
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1180
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1181
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1182
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1183
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1184
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1185
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1186 18
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1187
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1188