Lines Matching +full:default +full:- +full:input
4 less \- display the contents of a file in a terminal
6 .B "less \-?"
8 .B "less \-\-help"
10 .B "less \-V"
12 .B "less \-\-version"
14 .B "less [\-[+]aABcCdeEfFgGiIJKLmMnNqQrRsSuUVwWX\(ti]"
16 .B " [\-b \fIspace\/\fP] [\-h \fIlines\/\fP] [\-j \fIline\/\fP] [\-k \fIkeyfile\/\fP]"
18 .B " [\-{oO} \fIlogfile\/\fP] [\-p \fIpattern\/\fP] [\-P \fIprompt\/\fP] [\-t \fItag\/\fP]"
20 .B " [\-T \fItagsfile\/\fP] [\-x \fItab\/\fP,...] [\-y \fIlines\/\fP] [\-[z] \fIlines\/\fP]"
22 .B " [\-# \fIshift\/\fP] [+[+]\fIcmd\/\fP] [\-\-] [\fIfilename\/\fP]..."
32 does not have to read the entire input file before starting,
33 so with large input files it starts up faster than text editors like
51 In the following descriptions, \(haX means control-X.
52 ESC stands for the ESCAPE key; for example ESC-v means the
58 Scroll forward N lines, default one window (see option \-z below).
63 .IP "ESC-SPACE"
65 end-of-file in the process.
67 Scroll forward N lines, default 1.
70 Scroll forward N lines, default one half of the screen size.
71 If N is specified, it becomes the new default for
73 .IP "b or \(haB or ESC-v"
74 Scroll backward N lines, default one window (see option \-z below).
77 Like ESC-v, but if N is specified, it becomes the new window size.
79 Scroll backward N lines, default 1.
83 Scroll backward N lines, default one half of the screen size.
84 If N is specified, it becomes the new default for
90 .IP "ESC-) or RIGHTARROW"
91 Scroll horizontally right N characters, default half the screen width
92 (see the \-# option).
93 If a number N is specified, it becomes the default for future RIGHTARROW
95 While the text is scrolled, it acts as though the \-S option
97 .IP "ESC-( or LEFTARROW"
98 Scroll horizontally left N characters, default half the screen width
99 (see the \-# option).
100 If a number N is specified, it becomes the default for future RIGHTARROW
102 .IP "ESC-} or \(haRIGHTARROW"
104 .IP "ESC-{ or \(haLEFTARROW"
109 Repaint the screen, discarding any buffered input.
118 (The behavior is similar to the "tail \-f" command.)
122 you can also use \(haX or the character specified by the \-\-intr option.
123 If the input is a pipe and the \-\-exit-follow-on-close option is in effect,
125 will automatically stop waiting for data when the input side
127 .IP "ESC-F"
131 .IP "g or < or ESC-<"
132 Go to line N in the file, default 1 (beginning of file).
134 .IP "G or > or ESC->"
135 Go to line N in the file, default the end of the file.
138 standard input, rather than a file, is being read.)
139 .IP "ESC-G"
140 Same as G, except if no number N is specified and the input is standard input,
154 a number N may be used to specify the N-th bracket on the line.
162 a number N may be used to specify the N-th bracket on the line.
171 .IP "ESC-\(haF"
177 .IP "ESC-\(haB"
186 If the status column is enabled via the \-J option,
200 so the \(aq command can be used to switch between input files.
203 .IP "ESC-m"
207 Search forward in the file for the N-th line containing the pattern.
211 By default, searching is case-sensitive (uppercase and lowercase
212 are considered different); the \-i option can be used to change this.
214 (but see the \-a and \-j options, which change this).
231 or the settings of the \-a or \-j options.
240 Only text which has a non-empty match for the N-th parenthesized SUB-PATTERN
247 to match more than one sub-pattern.
259 Search backward in the file for the N-th line containing the pattern.
261 (but see the \-a and \-j options, which change this).
276 or the settings of the \-a or \-j options.
289 .IP "ESC-/pattern"
291 .IP "ESC-?pattern"
294 Repeat previous search, for N-th line containing the last pattern.
296 N-th line NOT containing the pattern.
304 .IP "ESC-n"
307 .IP "ESC-N"
310 .IP "ESC-u"
313 If highlighting is already off because of a previous ESC-u command,
316 (Highlighting can also be disabled by toggling the \-G option;
318 .IP "ESC-U"
319 Like ESC-u but also clears the saved search pattern.
320 If the status column is enabled via the \-J option,
344 below) from the list of files in the command line is re-examined.
359 (also see the \-" option).
366 If a number N is specified, the N-th next file is examined.
369 If a number N is specified, the N-th previous file is examined.
372 If a number N is specified, the N-th file in the list is examined.
377 See the \-t option for more details about tags.
381 Search forward in the file for the N-th next OSC 8 hyperlink.
383 Search backward in the file for the N-th previous OSC 8 hyperlink.
393 .IP \-
397 If a \(haP (CONTROL-P) is entered immediately after the dash,
399 If the option letter has a numeric value (such as \-b or \-h),
400 or a string value (such as \-P or \-t),
404 .IP \-\-
405 Like the \- command, but takes a long option name (see OPTIONS below)
409 message describing the new setting, as in the \- command.
410 .IP \-+
412 this will reset the option to its default setting
414 (The "\-+\fIX\fP" command does the same thing
415 as "\-+\fIX\fP" on the command line.)
416 This does not work for string-valued options.
417 .IP \-\-+
418 Like the \-+ command, but takes a long option name
420 .IP \-!
422 this will reset the option to the "opposite" of its default setting
424 This does not work for numeric or string-valued options.
425 .IP \-\-!
426 Like the \-!\& command, but takes a long option name
462 .IP "! shell-command"
463 Invokes a shell to run the shell-command given.
469 If a \(haP (CONTROL-P) is entered immediately after the !,
473 On MS-DOS, Windows, and OS/2 systems, the shell is the normal command processor.
474 .IP "# shell-command"
478 .IP "| <m> shell-command"
480 Pipes a section of the input file to the given shell command.
487 If a \(haP (CONTROL-P) is entered immediately after the mark letter,
490 Save the input to a file.
491 This works only if the input is a pipe, not an ordinary file.
533 However, there are default handlers for the
541 set LESS_OSC8_file to "-" to indicate that the default value
565 The \-\-intr option can be used to specify a different character
578 is running, via the "\-" command.
585 For example, \-\-quit-at-eof may be abbreviated \-\-quit, but not
586 \-\-qui, since both \-\-quit-at-eof and \-\-quiet begin with \-\-qui.
587 Some long option names are in uppercase, such as \-\-QUIT-AT-EOF, as
588 distinct from \-\-quit-at-eof.
591 For example, \-\-Quit-at-eof is equivalent to \-\-QUIT-AT-EOF.
595 to avoid typing "less \-options \&...\&" each time
600 setenv LESS "\-options"
605 LESS="\-options"; export LESS
607 On MS-DOS and Windows, you don't need the quotes, but you should
614 to its default value on the command line by beginning the command
615 line option with "\-+".
617 Some options like \-k or \-D require a string to follow the option letter.
619 For example, you can set two \-D options like this:
623 If the \-\-use-backslash option appears earlier in the options, then
626 If the \-\-use-backslash option is not in effect, then backslashes are
629 .IP "\-? or \-\-help"
634 it may be necessary to quote the question mark, thus: "\-\e?".)
635 .IP "\-a or \-\-search-skip-screen"
636 By default, forward searches start at the top of the displayed screen
640 see the \-j option for more about the target line).
641 The \-a option causes forward searches to instead start at
645 .IP "\-A or \-\-SEARCH-SKIP-SCREEN"
646 Causes all forward searches (not just non-repeated searches)
653 This was the default behavior in less versions prior to 441.
654 .IP "\-b\fIn\fP or \-\-buffers=\fIn\fP"
658 By default 64\ KB of buffer space is used for each file
659 (unless the file is a pipe; see the \-B option).
660 The \-b option specifies instead that \fIn\fP kilobytes of
662 If \fIn\fP is \-1, buffer space is unlimited; that is,
664 .IP "\-B or \-\-auto-buffers"
665 By default, when data is read from a pipe,
669 The \-B option disables this automatic allocation of buffers for pipes,
671 (or the amount of space specified by the \-b option)
673 Warning: use of \-B can result in erroneous display, since only the
677 .IP "\-c or \-\-clear-screen"
679 By default,
681 .IP "\-C or \-\-CLEAR-SCREEN"
682 Same as \-c, for compatibility with older versions of
684 .IP "\-d or \-\-dumb"
685 The \-d option suppresses the error message
689 The \-d option does not otherwise change the behavior of
692 .IP "\-D\fBx\fP\fIcolor\fP or \-\-color=\fBx\fP\fIcolor\fP"
704 Header lines and columns, set via the \-\-header option.
708 Line numbers enabled via the \-N option.
716 The highlight enabled via the \-w option.
717 .IP "1-5"
719 the first through fifth parenthesized sub-pattern.
720 Sub-pattern coloring works only if
735 The uppercase letters and digits can be used only when the \-\-use-color option is enabled.
742 overstriking with backspaces (see the \-U option) and to non-content
744 but not to text formatted using ANSI escape sequences with the \-R option
745 (but see the note below for different behavior on Windows and MS-DOS).
749 For example, \-Dug displays underlined text as green without underlining;
751 But \-Du+g displays underlined text as both green and in underlined format.
753 \fIcolor\fP is either a 4-bit color string or an 8-bit color string:
755 A 4-bit color string is one or two characters, where
776 For example, \-DNGk displays line numbers as bright green text on a black
777 background, and \-DEbR displays error messages as blue text on a
779 If either character is a "-" or is omitted, the corresponding color
782 An 8-bit color string is one or two decimal integers separated by a dot,
790 If either integer is a "-" or is omitted,
793 A 4-bit or 8-bit color string may be followed by one or more of the
804 On MS-DOS and Windows, the \-\-color option behaves
811 escape sequences with \-R,
812 in addition to overstruck and non-content text (but see \-Da).
817 but instead as a 4-bit
824 https://learn.microsoft.com/en-us/windows/console/char-info-str).
828 be used after a lowercase color selector on MS-DOS/Windows.
834 4-bit color sequences work, but "CSI 38;5" color sequences do not.
836 The \-Da option makes the behavior of \-\-color
837 more similar to its behavior on non-MS-DOS/Windows systems by (1)
842 earlier Windows systems, such sequences do not work regardless of the setting of \-Da).
844 .IP "\-e or \-\-quit-at-eof"
848 the second time it reaches end-of-file.
849 By default, the only way to exit
852 .IP "\-E or \-\-QUIT-AT-EOF"
855 to automatically exit the first time it reaches end-of-file.
856 .IP "\-f or \-\-force"
857 Forces non-regular files to be opened.
858 (A non-regular file is a directory or a device special file.)
860 By default,
862 will refuse to open non-regular files.
864 to be read, even if \-f is set.
865 .IP "\-F or \-\-quit-if-one-screen"
870 .IP "\-g or \-\-hilite-search"
874 The \-g option changes this behavior to highlight only the particular string
878 to run somewhat faster than the default.
879 .IP "\-G or \-\-HILITE-SEARCH"
880 The \-G option suppresses all highlighting of strings found by search commands.
881 .IP "\-h\fIn\fP or \-\-max-back-scroll=\fIn\fP"
886 backward, \-h0 is implied.)
887 .IP "\-i or \-\-ignore-case"
894 .IP "\-I or \-\-IGNORE-CASE"
895 Like \-i, but searches ignore case even if
897 .IP "\-j\fIn\fP or \-\-jump-target=\fIn\fP"
906 of the screen: the bottom line on the screen is \-1, the second
907 to the bottom is \-2, and so on.
913 If the \-\-header option is used and the target line specified by \-j
916 While the \-\-header option is active, the \-S option is ignored,
920 If any form of the \-j option is used,
924 unless changed by \-a or \-A.
925 For example, if "\-j4" is used, the target line is the
931 .IP "\-J or \-\-status-column"
936 The line is chopped with the \-S option, and
949 .IP "a-z, A-Z"
952 .IP "\-k\fIfilename\fP or \-\-lesskey-file=\fIfilename\fP"
958 Multiple \-k options may be specified.
964 Note the warning under "\-\-lesskey-content" below.
965 .IP "\-\-lesskey-src=\fIfilename\fP"
990 Note the warning under "\-\-lesskey-content" below.
991 .IP "\-\-lesskey-content=\fItext\fP"
1004 (\-\-lesskey, \-\-lesskey-src or \-\-lesskey-content). When using a
1007 default lesskey file, or to specify the file using the
1010 .IP "\-K or \-\-quit-on-intr"
1020 .IP "\-L or \-\-no-lessopen"
1022 (see the INPUT PREPROCESSOR section below).
1027 .IP "\-m or \-\-long-prompt"
1033 By default,
1036 .IP "\-M or \-\-LONG-PROMPT"
1041 .IP "\-n or \-\-line-numbers"
1043 The default (to use line numbers) may cause
1045 to run more slowly in some cases, especially with a very large input file.
1046 Suppressing line numbers with the \-n option will avoid this problem.
1051 .IP "\-N or \-\-LINE-NUMBERS"
1054 .IP "\-o\fIfilename\fP or \-\-log-file=\fIfilename\fP"
1057 to copy its input to the named file as it is being viewed.
1058 This applies only when the input file is a pipe,
1063 .IP "\-O\fIfilename\fP or \-\-LOG-FILE=\fIfilename\fP"
1064 The \-O option is like \-o, but it will overwrite an existing
1068 the \-o and \-O options can be used from within
1072 The "s" command is equivalent to specifying \-o from within
1074 .IP "\-p\fIpattern\fP or \-\-pattern=\fIpattern\fP"
1075 The \-p option on the command line is equivalent to
1080 .IP "\-P\fIprompt\fP or \-\-prompt=\fIprompt\fP"
1089 \-Ps followed by a string changes the default (short) prompt
1091 \-Pm changes the medium (\-m) prompt.
1092 \-PM changes the long (\-M) prompt.
1093 \-Ph changes the prompt for the help screen.
1094 \-P= changes the message printed by the = command.
1095 \-Pw changes the message printed while waiting for data (in the "F" command).
1100 .IP "\-q or \-\-quiet or \-\-silent"
1108 The default is to ring the terminal bell in all such cases.
1109 .IP "\-Q or \-\-QUIET or \-\-SILENT"
1114 .IP "\-r or \-\-raw-control-chars"
1116 The default is to display control characters using the caret notation;
1117 for example, a control-A (octal 001) is displayed as "\(haA"
1118 (with some exceptions as described under the \-U option).
1119 Warning: when the \-r option is used,
1127 USE OF THE \-r OPTION IS NOT RECOMMENDED.
1128 .IP "\-R or \-\-RAW-CONTROL-CHARS"
1129 Like \-r, but only ANSI "color" escape sequences and OSC 8 hyperlink
1131 Unlike \-r, the screen appearance is maintained correctly,
1137 normal (non-colored), regardless of any escape sequences in previous lines.
1146 or the two-character sequence "ESC \\".
1163 .IP "\-s or \-\-squeeze-blank-lines"
1168 .IP "\-S or \-\-chop-long-lines"
1172 the screen width is not displayed until you press RIGHT-ARROW.
1173 The default is to wrap long lines; that is, display the remainder
1175 See also the \-\-wordwrap option.
1176 .IP "\-t\fItag\fP or \-\-tag=\fItag\fP"
1177 The \-t option, followed immediately by a TAG,
1192 The \-t option may also be specified from within
1194 (using the \- command) as a way of examining a new file.
1195 The command ":t" is equivalent to specifying \-t from within
1197 .IP "\-T\fItagsfile\fP or \-\-tag-file=\fItagsfile\fP"
1199 .IP "\-u or \-\-underline-special"
1201 that is, they are sent to the terminal when they appear in the input.
1202 .IP "\-U or \-\-UNDERLINE-SPECIAL"
1205 that is, they are handled as specified by the \-r option.
1207 By default, if neither \-u nor \-U is given,
1218 Other carriage returns are handled as specified by the \-r option.
1222 if neither \-u nor \-U is in effect.
1224 See also the \-\-proc-backspace, \-\-proc-tab,
1225 and \-\-proc-return options.
1226 .IP "\-V or \-\-version"
1229 .IP "\-w or \-\-hilite-unread"
1236 If the \-\-status-line option is in effect, the entire line
1239 unless the \-J option is in effect,
1241 .IP "\-W or \-\-HILITE-UNREAD"
1242 Like \-w, but temporarily highlights the first new line after any
1244 .IP "\-x\fIn\fP,...\& or \-\-tabs=\fIn\fP,..."
1250 For example, "-x9,17" will set tabs at positions 9, 17, 25, 33, etc.
1251 The default for \fIn\fP is 8.
1252 .IP "\-X or \-\-no-init"
1257 .IP "\-y\fIn\fP or \-\-max-forw-scroll=\fIn\fP"
1261 The \-c or \-C option may be used to repaint from the top of
1263 By default, any forward movement causes scrolling.
1264 .IP "\-z\fIn\fP or \-\-window=\fIn\fP or \-\fIn\fP"
1265 Changes the default scrolling window size to \fIn\fP lines.
1266 The default is one screenful.
1275 For example, if the screen is 24 lines, \fI\-z\-4\fP sets the
1278 .IP "\-\(dq\fIcc\fP\ or\ \-\-quotes=\fIcc\fP"
1291 remains \-" (a dash followed by a double quote).
1292 .IP "\-\(ti or \-\-tilde"
1295 .IP "\-# or \-\-shift"
1296 Specifies the default number of positions to scroll horizontally
1298 If the number specified is zero, it sets the default number of
1305 .IP "\-\-exit-follow-on-close"
1308 will automatically stop waiting for more data when the input side of the
1310 .IP "\-\-file-size"
1311 If \-\-file-size is specified,
1316 Normally this is not done, because it can be slow if the input file
1317 is non-seekable (such as a pipe) and is large.
1318 .IP "\-\-follow-name"
1319 Normally, if the input file is renamed while an F command is executing,
1323 If \-\-follow-name is specified, during an F command
1331 .IP "\-\-header=\fIL\fP,\fIC\fP,\fIN\fP"
1343 (if the \-\-header command has been issued from within
1345 or 1 (if the \-\-header option has been given on the command line).
1346 The special form "\-\-header=\-" disables header lines and header columns,
1347 and is equivalent to "\-\-header=0,0".
1357 .IP "\-\-incsearch"
1362 .IP "\-\-intr=\fIc\fP"
1369 .IP "\-\-line-num-width=\fIn\fP"
1370 Sets the minimum width of the line number field when the \-N option is in effect
1372 The default is 7.
1373 .IP "\-\-match-shift=\fIn\fP"
1374 When \-S is in effect, if a search match is not visible
1388 .IP "\-\-modelines=\fIn\fP"
1392 will read the first \fIn\fP lines to try to find a vim-compatible
1412 then tab stops are automatically set as if \-\-tabs=\fIn\fP had been given.
1413 See the \-\-tabs description for acceptable values of \fIn\fP.
1415 .IP "\-\-mouse"
1416 Enables mouse input:
1419 left-click sets the "#" mark to the line where the mouse is clicked,
1420 and right-click (or any other) returns to the "#" mark position.
1421 If a left-click is performed with the mouse cursor on an OSC 8 hyperlink,
1423 If a left-click is performed with the mouse cursor on an OSC 8 hyperlink
1426 can be set by the \-\-wheel-lines option.
1427 Mouse input works only on terminals which support X11 mouse reporting,
1430 .IP "\-\-MOUSE"
1431 Like \-\-mouse, except the direction scrolled
1433 .IP "\-\-no-keypad"
1438 .IP "\-\-no-histdups"
1444 .IP "\-\-no-number-headers"
1445 Header lines (defined via the \-\-header option) are not assigned line numbers.
1447 .IP "\-\-no-search-header-lines"
1449 .IP "\-\-no-search-header-columns"
1451 .IP "\-\-no-search-headers"
1453 .IP "\-\-no-vbell"
1455 .IP "\-\-proc-backspace"
1456 If set, backspaces are handled as if neither the \-u option
1457 nor the \-U option were set.
1461 This option overrides the \-u and \-U options, so that display of
1463 If not set, backspace display is controlled by the \-u and \-U options.
1464 .IP "\-\-PROC-BACKSPACE"
1465 If set, backspaces are handled as if the \-U option were set;
1467 .IP "\-\-proc-return"
1468 If set, carriage returns are handled as if neither the \-u option
1469 nor the \-U option were set.
1471 This option overrides the \-u and \-U options, so that display of
1473 If not set, carriage return display is controlled by the \-u and \-U options.
1474 .IP "\-\-PROC-RETURN"
1475 If set, carriage returns are handled as if the \-U option were set;
1477 .IP "\-\-proc-tab"
1478 If set, tabs are handled as if the \-U option were not set.
1480 This option overrides the \-U option, so that display of
1482 If not set, tab display is controlled by the \-U options.
1483 .IP "\-\-PROC-TAB"
1484 If set, tabs are handled as if the \-U option were set;
1486 .IP "\-\-redraw-on-quit"
1494 .IP "\-\-rscroll=\fIc\fP"
1496 It may begin with a two-character attribute indicator like LESSBINFMT does.
1498 If set to "\-", truncated lines are not marked.
1499 .IP "\-\-save-marks"
1503 .IP "\-\-search-options=\fI...\fP"
1504 Sets default search modifiers.
1509 For example, setting \-\-search-options=W is the same as
1514 The value "-" disables all default search modifiers.
1515 .IP "\-\-show-preproc-errors"
1517 then exits with a non-zero exit code,
1520 .IP "\-\-status-col-width=\fIn\fP"
1521 Sets the width of the status column when the \-J option is in effect.
1522 The default is 2 characters.
1523 .IP "\-\-status-line"
1526 Also lines highlighted due to the \-w option will have
1528 If \-\-use-color is set, the line is colored rather than highlighted.
1529 .IP "\-\-use-backslash"
1531 After the \-\-use-backslash option, any backslash in an option string is
1534 .IP "\-\-use-color"
1536 The \-D option can be used to change the colors.
1540 https://www.ecma-international.org/publications-and-standards/standards/ecma-48).
1542 .IP "\-\-wheel-lines=\fIn\fP"
1544 and the \-\-mouse or \-\-MOUSE option is in effect.
1545 The default is 1 line.
1546 .IP "\-\-wordwrap"
1547 When the \-S option is not in use,
1550 The default is to wrap at any character.
1551 .IP \-\-
1552 A command line argument of "\-\-" marks the end of option arguments.
1554 This can be useful when viewing a file whose name begins with a "\-" or "+".
1579 in some MS-DOS and Windows systems because ESC is the line erase character.)
1583 .IP "LEFTARROW [ ESC-h ]"
1585 .IP "RIGHTARROW [ ESC-l ]"
1587 .IP "\(haLEFTARROW [ ESC-b or ESC-LEFTARROW ]"
1590 .IP "\(haRIGHTARROW [ ESC-w or ESC-RIGHTARROW ]"
1593 .IP "HOME [ ESC-0 ]"
1595 .IP "END [ ESC-$ ]"
1600 .IP "DELETE or [ ESC-x ]"
1602 .IP "\(haBACKSPACE [ ESC-BACKSPACE ]"
1605 .IP "\(haDELETE [ ESC-X or ESC-DELETE ]"
1608 .IP "UPARROW [ ESC-k ]"
1612 .IP "DOWNARROW [ ESC-j ]"
1622 (On MS-DOS and Windows systems, a "\e" is appended.)
1625 .IP "BACKTAB [ ESC-TAB ]"
1631 .IP "\(haU (Unix and OS/2) or ESC (MS-DOS and Windows)"
1634 If you have changed your line-kill character in Unix to something
1645 You may also change the line-editing keys (see LINE EDITING),
1661 On MS-DOS and Windows systems,
1674 A system-wide lesskey source file may also be set up to provide key bindings.
1676 system-wide file, key bindings in the local file take precedence over
1677 those in the system-wide file.
1680 uses that as the name of the system-wide lesskey file.
1683 looks in a standard place for the system-wide lesskey file:
1684 On Unix systems, the system-wide lesskey file is /usr/local/etc/syslesskey.
1689 On MS-DOS and Windows systems, the system-wide lesskey file is c:\e_syslesskey.
1690 On OS/2 systems, the system-wide lesskey file is c:\esyslesskey.ini.
1700 .SH "INPUT PREPROCESSOR"
1701 You may define an "input preprocessor" for
1705 opens a file, it first gives your input preprocessor a chance to modify the
1707 An input preprocessor is simply an executable program (or shell script),
1717 An input preprocessor receives one command line argument, the original filename,
1721 If the input preprocessor does not output a replacement filename,
1724 The input preprocessor is not called when viewing standard input.
1725 To set up an input preprocessor, set the LESSOPEN environment variable
1726 to a command line which will invoke your input preprocessor.
1729 when the input preprocessor command is invoked.
1734 called the input postprocessor,
1735 which may perform any desired clean-up action (such as deleting the
1739 To set up an input postprocessor, set the LESSCLOSE environment variable
1740 to a command line which will invoke your input postprocessor.
1759 uncompress \-c $1 >$TEMPFILE 2>/dev/null
1761 if [ \-s $TEMPFILE ]; then
1767 rm \-f $TEMPFILE
1787 It is also possible to set up an input preprocessor to
1793 An input preprocessor that works this way is called an input pipe.
1794 An input pipe, instead of writing the name of a replacement file on
1797 If the input pipe does not write any characters on its standard output,
1801 To use an input pipe,
1803 vertical bar (|) to signify that the input preprocessor is an input pipe.
1804 As with non-pipe input preprocessors, the command string must contain one
1805 occurrence of %s, which is replaced with the filename of the input file.
1816 *.Z) uncompress \-c $1 2>/dev/null
1846 When an input pipe is used, a LESSCLOSE postprocessor can be used,
1850 postprocessor is "\-".
1854 the input preprocessor or pipe is not used if
1856 is viewing standard input.
1857 However, if the first character of LESSOPEN is a dash (\-),
1858 the input preprocessor is used on standard input as well as other files.
1861 If standard input is being viewed, the input preprocessor is passed
1864 (|\-) or two vertical bars and a dash (||\-),
1865 the input pipe is used on standard input as well as other files.
1867 the input pipe command.
1870 There are three types of characters in the input file:
1897 Selects a character set appropriate for MS-DOS.
1900 .IP IBM-1047
1903 by setting either LESSCHARSET=IBM-1047 or LC_CTYPE=en_US
1905 .IP koi8-r
1909 .IP utf-8
1910 Selects the UTF-8 encoding of the ISO 10646 character set.
1911 UTF-8 is special in that it supports multi-byte characters in the input file.
1912 It is the only character set that supports multi-byte characters.
1943 IBM-1047 4cbcbc3b9cbccbccbb4c6bcc5b3cbbc4bc4bccbc
1946 koi8-r 8bcccbcc18b95.b128.
1953 but any of the strings "UTF-8", "UTF8", "utf-8" or "utf8"
1955 environment variables, then the default character set is utf-8.
1967 interface is also not available, the default character set is utf-8.
1971 (e.g.\& \(haA for control-A). Caret notation is used only if
1982 printf-style escape sequence (a % followed by x, X, o, d, etc.).
1985 The default if no LESSBINFMT is specified is "*s<%02X>".
1989 When the character set is utf-8, the LESSUTFBINFMT environment variable
1993 Its default value is "<U+%04lX>".
1998 Problematic octets in a UTF-8 file (octets of a truncated sequence,
1999 octets of a complete but non-shortest form sequence, invalid octets,
2002 of how the UTF-8 file is ill-formed.
2004 When the character set is utf-8, in rare cases it may be desirable to
2012 to a comma-separated list of
2021 If there are multiple comma-separated codepoint values,
2028 A wide (2-space) printable character.
2030 A binary (non-printable) character.
2038 E000-F8FF:p,F0000-FFFFD:p,100000-10FFFD:p
2043 The \-P option allows you to tailor the prompt to your preference.
2044 The string given to the \-P option replaces the specified prompt string.
2052 (References to the input file size below refer to the preprocessed size,
2053 if an input preprocessor is being used.)
2055 Replaced by the byte offset into the current input file.
2063 and a "j" means use the "target" line, as specified by the \-j option.
2065 Replaced by the size of the current input file.
2070 Replaced by the page number of a line in the input file.
2073 Replaced by the number of pages in the input file,
2074 or equivalently, the page number of the last line in the input file.
2080 Replaced by the name of the current input file.
2082 Replaced by the last component of the name of the current input file.
2084 Replaced by the shell-escaped name of the current input file.
2089 input files.
2091 Replaced by the line number of a line in the input file.
2094 Replaced by the line number of the last line in the input file.
2096 Replaced by the total number of input files.
2102 Replaced by the percent into the current input file, based on byte offsets.
2105 Replaced by the percent into the current input file, based on line numbers.
2114 However if viewing files via a tags list using the \-t option,
2117 Replaced by the name of the next input file in the list.
2119 If any item is unknown (for example, the file size if input
2139 True if the size of current input file is known.
2145 True if at end-of-file.
2147 True if there is an input filename
2148 (that is, if input is not a pipe).
2154 True if there is more than one input file.
2156 True if this is the first prompt in a new input file.
2158 True if the percent into the current input file, based on byte offsets,
2161 True if the percent into the current input file, based on line numbers,
2166 True if there is a next input file
2167 (that is, if the current input file is not the last one).
2177 ?f%f:Standard input.
2180 otherwise the string "Standard input".
2182 ?f%f \&.?ltLine %lt:?pt%pt\e%:?btByte %bt:-...
2192 ?n?f%f\ .?m(%T %i of %m)\ ..?e(END)\ ?x-\ Next\e:\ %x..%t
2196 than one input file.
2197 Then, if we are at end-of-file, the string "(END)" is printed
2200 This is the default prompt.
2202 the other two prompts (\-m and \-M respectively).
2206 ?n?f%f\ .?m(%T\ %i\ of\ %m)\ ..?e(END)\ ?x-\ Next\e:\ %x.:
2209 ?f%f\ .?n?m(%T\ %i\ of\ %m)\ ..?ltlines\ %lt-%lb?L/%L.\ :
2210 byte\ %bB?s/%s.\ .?e(END)\ ?x-\ Next\e:\ %x.:?pB%pB\e%..%t
2213 And here is the default message produced by the = command:
2216 ?f%f\ .?m(%T\ %i\ of\ %m)\ .?ltlines\ %lt-%lb?L/%L.\ .
2224 The default value for LESSEDIT is:
2231 line number, followed by the shell-escaped file name.
2234 changed to modify this default.
2252 use of lesskey files (-k and \-\-lesskey-src)
2254 input preprocessor (LESSOPEN environment variable)
2256 log files (s and \-o)
2268 use of tags files (-t)
2270 The LESSSECURE_ALLOW environment variable can be set to a comma-separated list
2297 The \-e option works differently.
2298 If the \-e option is not set,
2300 behaves as if the \-e option were set.
2301 If the \-e option is set,
2303 behaves as if the \-E option were set.
2305 The \-m option works differently.
2306 If the \-m option is not set, the medium prompt is used,
2307 and it is prefixed with the string "\-\-More\-\-".
2308 If the \-m option is set, the short prompt is used.
2310 The \-n option acts like the \-z option.
2311 The normal behavior of the \-n option is unavailable in this mode.
2313 The parameter to the \-p option is taken to be a
2328 over variables defined in the system-wide lesskey file.
2356 (default "m").
2360 (default "0123456789:;[?!"\(aq#%()*+\ ".
2362 Format for displaying non-printable, non-control characters.
2368 Command line to invoke the (optional) input-postprocessor.
2370 Name of the lessecho program (default "lessecho").
2377 Name of the command used by the \-t option to find global tags.
2385 If set to "\-" or "/dev/null", a history file is not used.
2386 The default depends on the operating system, but is usually:
2391 .IP "Windows and MS-DOS"
2398 The default is 100.
2400 Name of the default
2404 Name of the default
2408 The value is parsed as if it were the parameter of a \-\-lesskey-content option.
2410 Name of the default system-wide
2414 Name of the default system-wide
2425 Command line to invoke the (optional) input-preprocessor.
2435 Format for displaying non-printable Unicode code points.
2459 Duration (in milliseconds) after starting to read data from the input,
2461 The default is 4000 (4 seconds).
2476 A space-separated list of command line options.
2479 Options listed in LESS_UNSUPPORT can still be changed by the \- and \-\- commands.
2492 .BR more "-compatible mode."
2495 on MS-DOS, Windows, and OS/2 systems).
2518 Copyright (C) 1984-2024 Mark Nudelman
2530 Suite 330, Boston, MA 02111-1307, USA.