aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/less/less.man
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/less/less.man')
-rw-r--r--contrib/less/less.man80
1 files changed, 41 insertions, 39 deletions
diff --git a/contrib/less/less.man b/contrib/less/less.man
index f9dda92259c0..af19a477fac2 100644
--- a/contrib/less/less.man
+++ b/contrib/less/less.man
@@ -445,8 +445,8 @@ LESS(1) LESS(1)
buffer space is used for each file (unless the file is a pipe;
see the -B option). The -b option specifies instead that n
kilobytes of buffer space should be used for each file. If n is
- -1, buffer space is unlimited; that is, the entire file is read
- into memory.
+ -1, buffer space is unlimited; that is, the entire file can be
+ read into memory.
-B or --auto-buffers
By default, when data is read from a pipe, buffers are allocated
@@ -456,8 +456,8 @@ LESS(1) LESS(1)
buffers for pipes, so that only 64K (or the amount of space
specified by the -b option) is used for the pipe. Warning: use
of -B can result in erroneous display, since only the most
- recently viewed part of the file is kept in memory; any earlier
- data is lost.
+ recently viewed part of the piped data is kept in memory; any
+ earlier data is lost.
-c or --clear-screen
Causes full screen repaints to be painted from the top line
@@ -533,42 +533,44 @@ LESS(1) LESS(1)
-jn or --jump-target=n
Specifies a line on the screen where the "target" line is to be
- positioned. A target line is the object of a text search, tag
- search, jump to a line number, jump to a file percentage, or
- jump to a marked position. The screen line may be specified by
- a number: the top line on the screen is 1, the next is 2, and so
- on. The number may be negative to specify a line relative to
- the bottom of the screen: the bottom line on the screen is -1,
- the second to the bottom is -2, and so on. Alternately, the
- screen line may be specified as a fraction of the height of the
- screen, starting with a decimal point: .5 is in the middle of
- the screen, .3 is three tenths down from the first line, and so
- on. If the line is specified as a fraction, the actual line
+ positioned. The target line is the line specified by any com-
+ mand to search for a pattern, jump to a line number, jump to a
+ file percentage or jump to a tag. The screen line may be speci-
+ fied by a number: the top line on the screen is 1, the next is
+ 2, and so on. The number may be negative to specify a line rel-
+ ative to the bottom of the screen: the bottom line on the screen
+ is -1, the second to the bottom is -2, and so on. Alternately,
+ the screen line may be specified as a fraction of the height of
+ the screen, starting with a decimal point: .5 is in the middle
+ of the screen, .3 is three tenths down from the first line, and
+ so on. If the line is specified as a fraction, the actual line
number is recalculated if the terminal window is resized, so
that the target line remains at the specified fraction of the
- screen height. If the -j option is used, searches begin at the
- line immediately after the target line. For example, if "-j4"
- is used, the target line is the fourth line on the screen, so
- searches begin at the fifth line on the screen.
+ screen height. If any form of the -j option is used, forward
+ searches begin at the line immediately after the target line,
+ and backward searches begin at the target line. For example, if
+ "-j4" is used, the target line is the fourth line on the screen,
+ so forward searches begin at the fifth line on the screen.
-J or --status-column
- Displays a status column at the left edge of the screen. 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
+ Displays a status column at the left edge of the screen. 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.
-kfilename or --lesskey-file=filename
- Causes less to open and interpret the named file as a lesskey
+ Causes less to open and interpret the named file as a lesskey
(1) file. Multiple -k options may be specified. If the LESSKEY
- or LESSKEY_SYSTEM environment variable is set, or if a lesskey
+ or LESSKEY_SYSTEM environment variable is set, or if a lesskey
file is found in a standard place (see KEY BINDINGS), it is also
used as a lesskey file.
-K or --quit-on-intr
- Causes less to exit immediately when an interrupt character
- (usually ^C) is typed. Normally, an interrupt character causes
- less to stop whatever it is doing and return to its command
- prompt.
+ Causes less to exit immediately when an interrupt character
+ (usually ^C) is typed. Normally, an interrupt character causes
+ less to stop whatever it is doing and return to its command
+ prompt. Note that use of this option makes it impossible to
+ return to the command prompt from the "F" command.
-L or --no-lessopen
Ignore the LESSOPEN environment variable (see the INPUT PREPRO-
@@ -739,8 +741,8 @@ LESS(1) LESS(1)
-xn,... or --tabs=n,...
Sets tab stops. If only one n is specified, tab stops are set
at multiples of n. If multiple values separated by commas are
- specified, tab stops are set at those positions, and then
- continue with the same spacing as the last two. For example,
+ specified, tab stops are set at those positions, and then con-
+ tinue with the same spacing as the last two. For example,
-x9,17 will set tabs at positions 9, 17, 25, 33, etc. The
default for n is 8.
@@ -1159,10 +1161,10 @@ LESS(1) LESS(1)
is followed by a single character (shown as X above) which spec-
ifies the line whose byte offset is to be used. If the charac-
ter is a "t", the byte offset of the top line in the display is
- used, an "m" means use the middle line, a "b" means use the
- bottom line, a "B" means use the line just after the bottom
- line, and a "j" means use the "target" line, as specified by the
- -j option.
+ used, an "m" means use the middle line, a "b" means use the bot-
+ tom line, a "B" means use the line just after the bottom line,
+ and a "j" means use the "target" line, as specified by the -j
+ option.
%B Replaced by the size of the current input file.
@@ -1509,10 +1511,10 @@ LESS(1) LESS(1)
expressions turned off via ^R, and also does not occur when less is
compiled to use the PCRE regular expression library.
- In certain cases, when search highlighting is enabled and a search
- pattern begins with a ^, more text than the matching string may be
- highlighted. (This problem does not occur when less is compiled to use
- the POSIX regular expression package.)
+ In certain cases, when search highlighting is enabled and a search pat-
+ tern begins with a ^, more text than the matching string may be high-
+ lighted. (This problem does not occur when less is compiled to use the
+ POSIX regular expression package.)
On some systems, setlocale claims that ASCII characters 0 thru 31 are
control characters rather than binary characters. This causes less to
@@ -1554,4 +1556,4 @@ LESS(1) LESS(1)
- Version 415: 15 Nov 2007 LESS(1)
+ Version 416: 22 Nov 2007 LESS(1)