version 1.33, 2014/04/29 12:11:25 |
version 1.34, 2014/05/01 18:50:36 |
|
|
.Dt LESS 1 |
.Dt LESS 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm less , more |
.Nm less |
.Nd view files |
.Nd view files |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm less \*(Ba more |
.Nm less |
.Fl \&? |
.Op Fl #?~AaBCcdEeFfGgIiJKLMmNnQqRrSsUuVWwX |
.Nm less \*(Ba more |
.Op Fl b Ar n |
.Fl -help |
.Op Fl h Ar n |
.Nm less \*(Ba more |
.Op Fl j Ar n |
.Fl V |
|
.Nm less \*(Ba more |
|
.Fl -version |
|
.Nm less \*(Ba more |
|
.Bk -words |
|
.Op Fl Oo Cm + Oc Ns Cm AaBCcdEeFfGgIiJKLMmNnQqRrSsUuVWwX~ |
|
.Op Fl b Ar space |
|
.Op Fl h Ar lines |
|
.Op Fl j Ar line |
|
.Op Fl k Ar keyfile |
.Op Fl k Ar keyfile |
.Op Fl O | o Ar logfile |
.Op Fl O | o Ar logfile |
.Op Fl P Ar prompt |
.Op Fl P Ar prompt |
.Op Fl p Ar pattern |
.Op Fl p Ar pattern |
.Op Fl T Ar tagsfile |
.Op Fl T Ar tagsfile |
.Op Fl t Ar tag |
.Op Fl t Ar tag |
.Op Fl x Ar tab,... |
.Op Fl x Ar n Ns , Ns Ar ... |
.Op Fl y Ar lines |
.Op Fl y Ar n |
.Op Fl Oo Cm z Oc Ar lines |
.Op Fl Cm z Ar n |
.Op Fl # Ar shift |
.Op Ar |
.Xo Oo Cm \&+ Ns Oo Ns Cm \&+ Ns |
|
.Oc Ar cmd |
|
.Oc |
|
.Xc |
|
.Op Fl - |
|
.Op Ar filename ... |
|
.Ek |
|
.\" (See the |
.\" (See the |
.\" .Sx OPTIONS |
.\" .Sx OPTIONS |
.\" section for alternate option syntax with long option names.) |
.\" section for alternate option syntax with long option names.) |
|
|
most recently viewed part of the piped data is kept in memory; |
most recently viewed part of the piped data is kept in memory; |
any earlier data is lost. |
any earlier data is lost. |
.It Xo |
.It Xo |
.Fl b Ns Ar n | |
.Fl b Ar n | |
.Fl -buffers Ns = Ns Ar n |
.Fl -buffers Ns = Ns Ar n |
.Xc |
.Xc |
Specifies the amount of buffer space |
Specifies the amount of buffer space |
|
|
.Nm |
.Nm |
to run somewhat faster than the default. |
to run somewhat faster than the default. |
.It Xo |
.It Xo |
.Fl h Ns Ar n | |
.Fl h Ar n | |
.Fl -max-back-scroll Ns = Ns Ar n |
.Fl -max-back-scroll Ns = Ns Ar n |
.Xc |
.Xc |
Specifies a maximum number of lines to scroll backward. |
Specifies a maximum number of lines to scroll backward. |
|
|
The status column shows the lines that matched the current search. |
The status column shows the lines that matched the current search. |
The status column is also used if the -w or -W option is in effect. |
The status column is also used if the -w or -W option is in effect. |
.It Xo |
.It Xo |
.Fl j Ns Ar n | |
.Fl j Ar n | |
.Fl -jump-target Ns = Ns Ar n |
.Fl -jump-target Ns = Ns Ar n |
.Xc |
.Xc |
Specifies a line on the screen where the "target" line is to be positioned. |
Specifies a line on the screen where the "target" line is to be positioned. |
|
|
Note that use of this option makes it impossible to return to the |
Note that use of this option makes it impossible to return to the |
command prompt from the "F" command. |
command prompt from the "F" command. |
.It Xo |
.It Xo |
.Fl k Ns Ar filename | |
.Fl k Ar keyfile | |
.Fl -lesskey-file Ns = Ns Ar filename |
.Fl -lesskey-file Ns = Ns Ar keyfile |
.Xc |
.Xc |
Causes |
Causes |
.Nm |
.Nm |
|
|
.Sx PROMPTS |
.Sx PROMPTS |
below). |
below). |
.It Xo |
.It Xo |
.Fl O Ns Ar filename | |
.Fl O Ar logfile | |
.Fl -LOG-FILE Ns = Ns Ar filename |
.Fl -LOG-FILE Ns = Ns Ar logfile |
.Xc |
.Xc |
The -O option is like -o, but it will overwrite an existing |
The -O option is like -o, but it will overwrite an existing |
file without asking for confirmation. |
file without asking for confirmation. |
|
|
The "s" command is equivalent to specifying -o from within |
The "s" command is equivalent to specifying -o from within |
.Nm less . |
.Nm less . |
.It Xo |
.It Xo |
.Fl o Ns Ar filename | |
.Fl o Ar logfile | |
.Fl -log-file Ns = Ns Ar filename |
.Fl -log-file Ns = Ns Ar logfile |
.Xc |
.Xc |
Causes |
Causes |
.Nm |
.Nm |
|
|
.Nm |
.Nm |
will ask for confirmation before overwriting it. |
will ask for confirmation before overwriting it. |
.It Xo |
.It Xo |
.Fl P Ns Ar prompt | |
.Fl P Ar prompt | |
.Fl -prompt Ns = Ns Ar prompt |
.Fl -prompt Ns = Ns Ar prompt |
.Xc |
.Xc |
Provides a way to tailor the three prompt styles to your own preference. |
Provides a way to tailor the three prompt styles to your own preference. |
|
|
.Sx PROMPTS |
.Sx PROMPTS |
for more details. |
for more details. |
.It Xo |
.It Xo |
.Fl p Ns Ar pattern | |
.Fl p Ar pattern | |
.Fl -pattern Ns = Ns Ar pattern |
.Fl -pattern Ns = Ns Ar pattern |
.Xc |
.Xc |
The -p option on the command line is equivalent to specifying +/pattern; |
The -p option on the command line is equivalent to specifying +/pattern; |
|
|
.It Fl s | -squeeze-blank-lines |
.It Fl s | -squeeze-blank-lines |
Causes consecutive blank lines to be squeezed into a single blank line. |
Causes consecutive blank lines to be squeezed into a single blank line. |
.It Xo |
.It Xo |
.Fl T Ns Ar tagsfile | |
.Fl T Ar tagsfile | |
.Fl -tag-file Ns = Ns Ar tagsfile |
.Fl -tag-file Ns = Ns Ar tagsfile |
.Xc |
.Xc |
Specifies a tags file to be used instead of "tags". |
Specifies a tags file to be used instead of "tags". |
.It Xo |
.It Xo |
.Fl t Ns Ar tag | |
.Fl t Ar tag | |
.Fl -tag Ns = Ns Ar tag |
.Fl -tag Ns = Ns Ar tag |
.Xc |
.Xc |
The -t option, followed immediately by a TAG, |
The -t option, followed immediately by a TAG, |
|
|
This is sometimes desirable if the deinitialization string does |
This is sometimes desirable if the deinitialization string does |
something unnecessary, like clearing the screen. |
something unnecessary, like clearing the screen. |
.It Xo |
.It Xo |
.Fl x Ns Ar n,... | |
.Fl x Ar n Ns , Ns Ar ... | |
.Fl -tabs Ns = Ns Ar n,... |
.Fl -tabs Ns = Ns Ar n Ns , Ns Ar ... |
.Xc |
.Xc |
Sets tab stops. |
Sets tab stops. |
If only one n is specified, tab stops are set at multiples of n. |
If only one n is specified, tab stops are set at multiples of n. |
|
|
For example, -x9,17 will set tabs at positions 9, 17, 25, 33, etc. |
For example, -x9,17 will set tabs at positions 9, 17, 25, 33, etc. |
The default for n is 8. |
The default for n is 8. |
.It Xo |
.It Xo |
.Fl y Ns Ar n | |
.Fl y Ar n | |
.Fl -max-forw-scroll Ns = Ns Ar n |
.Fl -max-forw-scroll Ns = Ns Ar n |
.Xc |
.Xc |
Specifies a maximum number of lines to scroll forward. |
Specifies a maximum number of lines to scroll forward. |
|
|
the screen if desired. |
the screen if desired. |
By default, any forward movement causes scrolling. |
By default, any forward movement causes scrolling. |
.It Xo |
.It Xo |
.Fl Oo Cm z Oc Ns Ar n | |
.Fl z Ar n | |
.Fl -window Ns = Ns Ar n |
.Fl -window Ns = Ns Ar n |
.Xc |
.Xc |
Changes the default scrolling window size to n lines. |
Changes the default scrolling window size to n lines. |