diff options
author | delphij <delphij@FreeBSD.org> | 2007-11-26 08:57:30 +0000 |
---|---|---|
committer | delphij <delphij@FreeBSD.org> | 2007-11-26 08:57:30 +0000 |
commit | 6aa3e25391d160482339ee072c010bcd22dfbbd1 (patch) | |
tree | 16a20dc2cde29bebdf20bd816c0ded0f5a70d738 /contrib/less/less.man | |
parent | 9fc5d689bc82d338622a61df0809dbc8114a76d8 (diff) | |
download | FreeBSD-src-6aa3e25391d160482339ee072c010bcd22dfbbd1.zip FreeBSD-src-6aa3e25391d160482339ee072c010bcd22dfbbd1.tar.gz |
Virgin import of less v416.
Diffstat (limited to 'contrib/less/less.man')
-rw-r--r-- | contrib/less/less.man | 80 |
1 files changed, 41 insertions, 39 deletions
diff --git a/contrib/less/less.man b/contrib/less/less.man index f9dda92..af19a47 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 [4mn[0m kilobytes of buffer space should be used for each file. If [4mn[24m 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) -j[4mn[24m or --jump-target=[4mn[0m 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. -k[4mfilename[24m or --lesskey-file=[4mfilename[0m - Causes [4mless[24m to open and interpret the named file as a [4mlesskey[0m + Causes [4mless[24m to open and interpret the named file as a [4mlesskey[0m (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 [4mlesskey[24m file. -K or --quit-on-intr - Causes [4mless[24m to exit immediately when an interrupt character - (usually ^C) is typed. Normally, an interrupt character causes - [4mless[24m to stop whatever it is doing and return to its command - prompt. + Causes [4mless[24m to exit immediately when an interrupt character + (usually ^C) is typed. Normally, an interrupt character causes + [4mless[24m 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) -x[4mn[24m,... or --tabs=[4mn[24m,... Sets tab stops. If only one [4mn[24m is specified, tab stops are set at multiples of [4mn[24m. 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, [4m-x9,17[24m will set tabs at positions 9, 17, 25, 33, etc. The default for [4mn[24m is 8. @@ -1159,10 +1161,10 @@ LESS(1) LESS(1) is followed by a single character (shown as [4mX[24m 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 [4mless[24m 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, [4msetlocale[24m claims that ASCII characters 0 thru 31 are control characters rather than binary characters. This causes [4mless[24m to @@ -1554,4 +1556,4 @@ LESS(1) LESS(1) - Version 415: 15 Nov 2007 LESS(1) + Version 416: 22 Nov 2007 LESS(1) |