Lines Matching +full:input +full:- +full:only
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
50 In the following descriptions, \(haX means control-X.
51 ESC stands for the ESCAPE key; for example ESC-v means the
57 Scroll forward N lines, default one window (see option \-z below).
58 If N is more than the screen size, only the final screenful is displayed.
69 .IP "b or \(haB or ESC-v"
70 Scroll backward N lines, default one window (see option \-z below).
71 If N is more than the screen size, only the final screenful is displayed.
73 Like ESC-v, but if N is specified, it becomes the new window size.
86 .IP "ESC-SPACE"
89 .IP "ESC-b"
92 .IP "ESC-j"
95 .IP "ESC-k"
97 .IP "ESC-) or RIGHTARROW"
99 (see the \-# option).
102 While the text is scrolled, it acts as though the \-S option
104 .IP "ESC-( or LEFTARROW"
106 (see the \-# option).
109 .IP "ESC-} or \(haRIGHTARROW"
111 .IP "ESC-{ or \(haLEFTARROW"
116 Repaint the screen, discarding any buffered input.
125 (The behavior is similar to the "tail \-f" command.)
129 you can also use \(haX or the character specified by the \-\-intr option.
130 If the input is a pipe and the \-\-exit-follow-on-close option is in effect,
132 will automatically stop waiting for data when the input side
134 .IP "ESC-F"
138 .IP "g or < or ESC-<"
141 .IP "G or > or ESC->"
145 standard input, rather than a file, is being read.)
146 .IP "ESC-G"
147 Same as G, except if no number N is specified and the input is standard input,
161 a number N may be used to specify the N-th bracket on the line.
169 a number N may be used to specify the N-th bracket on the line.
178 .IP "ESC-\(haF"
184 .IP "ESC-\(haB"
193 If the status column is enabled via the \-J option,
207 so the \(aq command can be used to switch between input files.
210 .IP "ESC-m"
214 Search forward in the file for the N-th line containing the pattern.
218 By default, searching is case-sensitive (uppercase and lowercase
219 are considered different); the \-i option can be used to change this.
221 (but see the \-a and \-j options, which change this).
238 or the settings of the \-a or \-j options.
247 Only text which has a non-empty match for the N-th parenthesized SUB-PATTERN
252 (Supported only if
257 to match more than one sub-pattern.
269 Search backward in the file for the N-th line containing the pattern.
271 (but see the \-a and \-j options, which change this).
286 or the settings of the \-a or \-j options.
301 .IP "ESC-/pattern"
303 .IP "ESC-?pattern"
306 Repeat previous search, for N-th line containing the last pattern.
308 N-th line NOT containing the pattern.
318 .IP "ESC-n"
321 .IP "ESC-N"
324 .IP "ESC-u"
327 If highlighting is already off because of a previous ESC-u command,
330 (Highlighting can also be disabled by toggling the \-G option;
332 .IP "ESC-U"
333 Like ESC-u but also clears the saved search pattern.
334 If the status column is enabled via the \-J option,
337 Display only lines which match the pattern;
344 Multiple & commands may be entered, in which case only lines
350 Display only lines which do NOT match the pattern.
358 below) from the list of files in the command line is re-examined.
373 (also see the \-" option).
380 If a number N is specified, the N-th next file is examined.
383 If a number N is specified, the N-th previous file is examined.
386 If a number N is specified, the N-th file in the list is examined.
391 See the \-t option for more details about tags.
395 Search forward in the file for the N-th next OSC 8 hyperlink.
397 Search backward in the file for the N-th previous OSC 8 hyperlink.
407 .IP \-
411 If a \(haP (CONTROL-P) is entered immediately after the dash,
413 If the option letter has a numeric value (such as \-b or \-h),
414 or a string value (such as \-P or \-t),
418 .IP \-\-
419 Like the \- command, but takes a long option name (see OPTIONS below)
425 message describing the new setting, as in the \- command.
426 .IP \-+
430 (The "\-+\fIX\fP" command does the same thing
431 as "\-+\fIX\fP" on the command line.)
432 This does not work for string-valued options.
433 .IP \-\-+
434 Like the \-+ command, but takes a long option name
436 .IP \-!
440 This does not work for numeric or string-valued options.
441 .IP \-\-!
442 Like the \-!\& command, but takes a long option name
478 .IP "! shell-command"
479 Invokes a shell to run the shell-command given.
485 If a \(haP (CONTROL-P) is entered immediately after the !,
489 On MS-DOS, Windows, and OS/2 systems, the shell is the normal command processor.
490 .IP "# shell-command"
494 .IP "| <m> shell-command"
496 Pipes a section of the input file to the given shell command.
503 If a \(haP (CONTROL-P) is entered immediately after the mark letter,
506 Save the input to a file.
507 This works only if the input is a pipe, not an ordinary file.
557 set LESS_OSC8_file to "-" to indicate that the default value
581 The \-\-intr option can be used to specify a different character
583 This command works only on systems that support the
594 is running, via the "\-" command.
601 For example, \-\-mouse may be abbreviated \-\-mou, but not
602 \-\-mo, since both \-\-mouse and \-\-modelines begin with \-\-mo.
603 Some long option names are in uppercase, such as \-\-QUIT-AT-EOF, as
604 distinct from \-\-quit-at-eof.
605 Such option names need only have their first letter capitalized;
607 For example, \-\-Quit-at-eof is equivalent to \-\-QUIT-AT-EOF.
611 to avoid typing "less \-options \&...\&" each time
616 setenv LESS "\-options"
621 LESS="\-options"; export LESS
623 On MS-DOS and Windows, you don't need the quotes, but you should
631 line option with "\-+".
633 Some options like \-k or \-D require a string to follow the option letter.
635 For example, you can set two \-D options like this:
639 If the \-\-use-backslash option appears earlier in the options, then
642 If the \-\-use-backslash option is not in effect, then backslashes are
645 .IP "\-? or \-\-help"
650 it may be necessary to quote the question mark, thus: "\-\e?".)
651 .IP "\-a or \-\-search-skip-screen"
656 see the \-j option for more about the target line).
657 The \-a option causes forward searches to instead start at
661 .IP "\-A or \-\-SEARCH-SKIP-SCREEN"
662 Causes all forward searches (not just non-repeated searches)
670 .IP "\-b\fIn\fP or \-\-buffers=\fIn\fP"
675 (unless the file is a pipe; see the \-B option).
676 The \-b option specifies instead that \fIn\fP kilobytes of
678 If \fIn\fP is \-1, buffer space is unlimited; that is,
680 .IP "\-B or \-\-auto-buffers"
685 The \-B option disables this automatic allocation of buffers for pipes,
686 so that only 64\ KB
687 (or the amount of space specified by the \-b option)
689 Warning: use of \-B can result in erroneous display, since only the
693 .IP "\-c or \-\-clear-screen"
697 .IP "\-C or \-\-CLEAR-SCREEN"
698 Same as \-c, for compatibility with older versions of
700 .IP "\-d or \-\-dumb"
701 The \-d option suppresses the error message
705 The \-d option does not otherwise change the behavior of
708 .IP "\-D\fBx\fP\fIcolor\fP or \-\-color=\fBx\fP\fIcolor\fP"
720 Header lines and columns, set via the \-\-header option.
724 Line numbers enabled via the \-N option.
732 The highlight enabled via the \-w option.
733 .IP "1-5"
735 the first through fifth parenthesized sub-pattern.
736 Sub-pattern coloring works only if
751 The uppercase letters and digits can be used only when the \-\-use-color option is enabled.
758 overstriking with backspaces (see the \-U option) and to non-content
760 but not to text formatted using ANSI escape sequences with the \-R option
761 (but see the note below for different behavior on Windows and MS-DOS).
765 For example, \-Dug displays underlined text as green without underlining;
767 But \-Du+g displays underlined text as both green and in underlined format.
769 \fIcolor\fP is either a 4-bit color string or an 8-bit color string:
771 A 4-bit color string is one or two characters, where
792 For example, \-DNGk displays line numbers as bright green text on a black
793 background, and \-DEbR displays error messages as blue text on a
795 If either character is a "-" or is omitted, the corresponding color
798 An 8-bit color string is one or two decimal integers separated by a dot,
805 If either integer is a "-" or is omitted,
808 A 4-bit or 8-bit color string may be followed by one or more of the
819 On MS-DOS and Windows, the \-\-color option behaves
826 escape sequences with \-R,
827 in addition to overstruck and non-content text (but see \-Da).
832 but instead as a 4-bit
838 .UR https://learn.microsoft.com/en-us/windows/console/char-info-str
842 be used after a lowercase color selector on MS-DOS/Windows.
847 Only a limited set of ANSI escape sequences to set color in the content work correctly.
848 4-bit color sequences work, but "CSI 38;5" color sequences do not.
850 The \-Da option makes the behavior of \-\-color
851 more similar to its behavior on non-MS-DOS/Windows systems by (1)
855 work by passing them to the terminal (only on Windows 10 and later; on
856 earlier Windows systems, such sequences do not work regardless of the setting of \-Da).
858 .IP "\-e or \-\-quit-at-eof"
862 the second time it reaches end-of-file.
863 By default, the only way to exit
866 .IP "\-E or \-\-QUIT-AT-EOF"
869 to automatically exit the first time it reaches end-of-file.
870 .IP "\-f or \-\-force"
871 Forces non-regular files to be opened.
872 (A non-regular file is a directory or a device special file.)
876 will refuse to open non-regular files.
878 to be read, even if \-f is set.
879 .IP "\-F or \-\-quit-if-one-screen"
885 .IP "\-g or \-\-hilite-search"
889 The \-g option changes this behavior to highlight only the particular string
894 .IP "\-G or \-\-HILITE-SEARCH"
895 The \-G option suppresses all highlighting of strings found by search commands.
896 .IP "\-h\fIn\fP or \-\-max-back-scroll=\fIn\fP"
901 backward, \-h0 is implied.)
902 .IP "\-i or \-\-ignore-case"
909 .IP "\-I or \-\-IGNORE-CASE"
910 Like \-i, but searches ignore case even if
912 .IP "\-j\fIn\fP or \-\-jump-target=\fIn\fP"
921 of the screen: the bottom line on the screen is \-1, the second
922 to the bottom is \-2, and so on.
928 If the \-\-header option is used and the target line specified by \-j
933 If any form of the \-j option is used,
937 unless changed by \-a or \-A.
938 For example, if "\-j4" is used, the target line is the
944 .IP "\-J or \-\-status-column"
949 The line is chopped with the \-S option, and
962 .IP "a-z, A-Z"
965 .IP "\-k\fIfilename\fP or \-\-lesskey-file=\fIfilename\fP"
971 Multiple \-k options may be specified.
977 Note the warning under "\-\-lesskey-content" below.
978 .IP "\-\-lesskey-src=\fIfilename\fP"
1000 Note the warning under "\-\-lesskey-content" below.
1001 .IP "\-\-lesskey-content=\fItext\fP"
1016 (\-\-lesskey, \-\-lesskey-src or \-\-lesskey-content). When using a
1022 .IP "\-K or \-\-quit-on-intr"
1032 .IP "\-L or \-\-no-lessopen"
1034 (see the INPUT PREPROCESSOR section below).
1037 but it will apply only to files opened subsequently, not to the
1039 .IP "\-m or \-\-long-prompt"
1048 .IP "\-M or \-\-LONG-PROMPT"
1053 .IP "\-n or \-\-line-numbers"
1057 to run more slowly in some cases, especially with a very large input file.
1062 .IP "\-N or \-\-LINE-NUMBERS"
1065 .IP "\-o\fIfilename\fP or \-\-log-file=\fIfilename\fP"
1068 to copy its input to the named file as it is being viewed.
1069 This applies only when the input file is a pipe,
1074 .IP "\-O\fIfilename\fP or \-\-LOG-FILE=\fIfilename\fP"
1075 The \-O option is like \-o, but it will overwrite an existing
1079 the \-o and \-O options can be used from within
1083 The "s" command is equivalent to specifying \-o from within
1085 .IP "\-p\fIpattern\fP or \-\-pattern=\fIpattern\fP"
1086 The \-p option on the command line is equivalent to
1091 .IP "\-P\fIprompt\fP or \-\-prompt=\fIprompt\fP"
1100 \-Ps followed by a string changes the default (short) prompt
1102 \-Pm changes the medium (\-m) prompt.
1103 \-PM changes the long (\-M) prompt.
1104 \-Ph changes the prompt for the help screen.
1105 \-P= changes the message printed by the = command.
1106 \-Pw changes the message printed while waiting for data (in the "F" command).
1111 .IP "\-q or \-\-quiet or \-\-silent"
1120 .IP "\-Q or \-\-QUIET or \-\-SILENT"
1125 .IP "\-r or \-\-raw-control-chars"
1128 for example, a control-A (octal 001) is displayed as "\(haA"
1129 (with some exceptions as described under the \-U option).
1130 Warning: when the \-r option is used,
1138 USE OF THE \-r OPTION IS DANGEROUS AND IS NOT RECOMMENDED.
1140 The \-r option can be set on the command line or via the \- command,
1142 If \-r appears in a LESS environment variable, it is treated as if it were \-R.
1143 .IP "\-R or \-\-RAW-CONTROL-CHARS"
1144 Like \-r, but only a limited set of escape
1146 Unlike \-r, the screen appearance is maintained correctly.
1156 4. OSC sequences starting with a non-standard introductory character
1165 Color escape sequences are only supported when the color
1168 normal (non-colored), regardless of any escape sequences in previous lines.
1187 as above, or the two-character sequence "ESC \\".
1188 .IP "\-s or \-\-squeeze-blank-lines"
1193 .IP "\-S or \-\-chop-long-lines"
1197 the screen width is not displayed until you press RIGHT-ARROW.
1200 See also the \-\-wordwrap option.
1201 While the \-\-header option is active, the \-S option is ignored,
1203 .IP "\-t\fItag\fP or \-\-tag=\fItag\fP"
1204 The \-t option, followed immediately by a TAG,
1218 The \-t option may also be specified from within
1220 (using the \- command) as a way of examining a new file.
1221 The command ":t" is equivalent to specifying \-t from within
1223 .IP "\-T\fItagsfile\fP or \-\-tag-file=\fItagsfile\fP"
1225 .IP "\-u or \-\-underline-special"
1227 that is, they are sent to the terminal when they appear in the input.
1228 .IP "\-U or \-\-UNDERLINE-SPECIAL"
1231 that is, they are handled as specified by the \-r option.
1233 By default, if neither \-u nor \-U is given,
1244 Other carriage returns are handled as specified by the \-r option.
1248 if neither \-u nor \-U is in effect.
1250 See also the \-\-proc-backspace, \-\-proc-tab,
1251 and \-\-proc-return options.
1252 .IP "\-V or \-\-version"
1255 .IP "\-w or \-\-hilite-unread"
1262 If the \-\-status-line option is in effect, the entire line
1264 Otherwise, only the text in the line is highlighted,
1265 unless the \-J option is in effect,
1266 in which case only the status column is highlighted.
1267 .IP "\-W or \-\-HILITE-UNREAD"
1268 Like \-w, but temporarily highlights the first new line after any
1270 .IP "\-x\fIn\fP,...\& or \-\-tabs=\fIn\fP,..."
1272 If only one \fIn\fP is specified, tab stops are set at multiples of \fIn\fP.
1276 For example, "-x9,17" will set tabs at positions 9, 17, 25, 33, etc.
1278 .IP "\-X or \-\-no-init"
1283 .IP "\-y\fIn\fP or \-\-max-forw-scroll=\fIn\fP"
1287 The \-c or \-C option may be used to repaint from the top of
1290 .IP "\-z\fIn\fP or \-\-window=\fIn\fP or \-\fIn\fP"
1301 For example, if the screen is 24 lines, \fI\-z\-4\fP sets the
1304 .IP "\-\(dq\fIcc\fP\ or\ \-\-quotes=\fIcc\fP"
1317 remains \-" (a dash followed by a double quote).
1318 .IP "\-\(ti or \-\-tilde"
1321 .IP "\-# or \-\-shift"
1331 .IP "\-\-exit-follow-on-close"
1334 will automatically stop waiting for more data when the input side of the
1336 .IP "\-\-file-size"
1337 If \-\-file-size is specified,
1342 Normally this is not done, because it can be slow if the input file
1343 is non-seekable (such as a pipe) and is large.
1344 .IP "\-\-follow-name"
1345 Normally, if the input file is renamed while an F command is executing,
1349 If \-\-follow-name is specified, during an F command
1357 .IP "\-\-form-feed"
1361 .IP "\-\-header=\fIL\fP,\fIC\fP,\fIN\fP"
1373 (if the \-\-header command has been issued from within
1375 or 1 (if the \-\-header option has been given on the command line).
1376 The special form "\-\-header=\-" disables header lines and header columns,
1377 and is equivalent to "\-\-header=0,0".
1387 While the \-\-header option is active,
1389 and the \-S option is ignored.
1391 .IP "\-\-incsearch"
1396 .IP "\-\-intr=\fIc\fP"
1403 .IP "\-\-line-num-width=\fIn\fP"
1404 Sets the minimum width of the line number field when the \-N option is in effect
1407 .IP "\-\-match-shift=\fIn\fP"
1408 When \-S is in effect, if a search match is not visible
1422 .IP "\-\-modelines=\fIn\fP"
1426 will read the first \fIn\fP lines to try to find a vim-compatible
1446 then tab stops are automatically set as if \-\-tabs=\fIn\fP had been given.
1447 See the \-\-tabs description for acceptable values of \fIn\fP.
1449 .IP "\-\-mouse"
1450 Enables mouse input:
1453 left-click sets the "#" mark to the line where the mouse is clicked,
1454 and right-click (or any other) returns to the "#" mark position.
1456 If a left-click is performed with the mouse cursor on an OSC 8 hyperlink,
1458 If a left-click is performed with the mouse cursor on an OSC 8 hyperlink
1461 can be set by the \-\-wheel-lines option.
1462 Mouse input works only on terminals which support X11 mouse reporting,
1465 .IP "\-\-MOUSE"
1466 Like \-\-mouse, except the direction scrolled
1468 .IP "\-\-no-edit-warn"
1471 (see the INPUT PREPROCESSOR section below).
1472 .IP "\-\-no-keypad"
1477 .IP "\-\-no-histdups"
1481 Thus, a given string will appear only once in the history list.
1483 .IP "\-\-no-number-headers"
1484 Header lines (defined via the \-\-header option) are not assigned line numbers.
1486 .IP "\-\-no-paste"
1487 If the terminal supports xterm-compatible "bracketed paste",
1494 .IP "\-\-no-search-header-lines"
1496 .IP "\-\-no-search-header-columns"
1498 .IP "\-\-no-search-headers"
1500 .IP "\-\-no-vbell"
1502 .IP "\-\-proc-backspace"
1503 If set, backspaces are handled as if neither the \-u option
1504 nor the \-U option were set.
1508 This option overrides the \-u and \-U options, so that display of
1510 If not set, backspace display is controlled by the \-u and \-U options.
1511 .IP "\-\-PROC-BACKSPACE"
1512 If set, backspaces are handled as if the \-U option were set;
1514 .IP "\-\-proc-return"
1515 If set, carriage returns are handled as if neither the \-u option
1516 nor the \-U option were set.
1518 This option overrides the \-u and \-U options, so that display of
1520 If not set, carriage return display is controlled by the \-u and \-U options.
1521 .IP "\-\-PROC-RETURN"
1522 If set, carriage returns are handled as if the \-U option were set;
1524 .IP "\-\-proc-tab"
1525 If set, tabs are handled as if the \-U option were not set.
1527 This option overrides the \-U option, so that display of
1529 If not set, tab display is controlled by the \-U option.
1530 .IP "\-\-PROC-TAB"
1531 If set, tabs are handled as if the \-U option were set;
1533 .IP "\-\-redraw-on-quit"
1541 .IP "\-\-rscroll=\fIc\fP"
1543 It may begin with a two-character attribute indicator like LESSBINFMT does.
1545 If set to "\-", truncated lines are not marked.
1546 .IP "\-\-save-marks"
1550 .IP "\-\-search-options=\fI...\fP"
1556 For example, setting \-\-search-options=W is the same as
1561 The value "-" disables all default search modifiers.
1562 .IP "\-\-show-preproc-errors"
1564 then exits with a non-zero exit code,
1567 .IP "\-\-status-col-width=\fIn\fP"
1568 Sets the width of the status column when the \-J option is in effect.
1570 .IP "\-\-status-line"
1573 Also lines highlighted due to the \-w option will have
1575 If \-\-use-color is set, the line is colored rather than highlighted.
1576 .IP "\-\-use-backslash"
1578 After the \-\-use-backslash option, any backslash in an option string is
1581 .IP "\-\-use-color"
1583 The \-D option can be used to change the colors.
1584 Colored text works only if the terminal supports
1586 .UR https://www.ecma-international.org/publications-and-standards/standards/ecma-48
1588 .IP "\-\-wheel-lines=\fIn\fP"
1590 and the \-\-mouse or \-\-MOUSE option is in effect.
1592 .IP "\-\-wordwrap"
1593 When the \-S option is not in use,
1597 .IP \-\-
1598 A command line argument of "\-\-" marks the end of option arguments.
1600 This can be useful when viewing a file whose name begins with a "\-" or "+".
1625 on some MS-DOS and Windows systems because ESC is the line erase character.)
1629 .IP "LEFTARROW [ ESC-h ]"
1631 .IP "RIGHTARROW [ ESC-l ]"
1633 .IP "\(haLEFTARROW [ ESC-b or ESC-LEFTARROW ]"
1636 .IP "\(haRIGHTARROW [ ESC-w or ESC-RIGHTARROW ]"
1639 .IP "HOME [ ESC-0 ]"
1641 .IP "END [ ESC-$ ]"
1646 .IP "DELETE or [ ESC-x ]"
1648 .IP "\(haBACKSPACE [ ESC-BACKSPACE ]"
1651 .IP "\(haDELETE [ ESC-X or ESC-DELETE ]"
1654 .IP "UPARROW [ ESC-k ]"
1658 .IP "DOWNARROW [ ESC-j ]"
1668 (On MS-DOS and Windows systems, a "\e" is appended.)
1671 .IP "BACKTAB [ ESC-TAB ]"
1677 .IP "\(haU (Unix and OS/2) or ESC (MS-DOS and Windows)"
1680 If you have changed your line-kill character in Unix to something
1691 You may also change the line-editing keys (see LINE EDITING),
1707 On MS-DOS and Windows systems,
1720 A system-wide lesskey source file may also be set up to provide key bindings.
1722 system-wide file, key bindings in the local file take precedence over
1723 those in the system-wide file.
1726 uses that as the name of the system-wide lesskey file.
1729 looks in a standard place for the system-wide lesskey file:
1730 On Unix systems, the system-wide lesskey file is /usr/local/etc/syslesskey.
1735 On MS-DOS and Windows systems, the system-wide lesskey file is c:\e_syslesskey.
1736 On OS/2 systems, the system-wide lesskey file is c:\esyslesskey.ini.
1746 .SH "INPUT PREPROCESSOR"
1747 You may define an "input preprocessor" for
1751 opens a file, it first gives the input preprocessor a chance to modify the
1753 An input preprocessor is simply an executable program (or shell script),
1763 An input preprocessor receives one command line argument, the original filename,
1767 If the input preprocessor does not output a replacement filename,
1770 The input preprocessor is not called when viewing standard input.
1771 To set up an input preprocessor, set the LESSOPEN environment variable
1772 to a command line which will invoke your input preprocessor.
1775 when the input preprocessor command is invoked.
1780 called the input postprocessor,
1781 which may perform any desired clean-up action (such as deleting the
1785 To set up an input postprocessor, set the LESSCLOSE environment variable
1786 to a command line which will invoke your input postprocessor.
1805 uncompress \-c $1 >$TEMPFILE 2>/dev/null
1807 if [ \-s $TEMPFILE ]; then
1813 rm \-f $TEMPFILE
1833 It is also possible to set up an input preprocessor to
1839 An input preprocessor that works this way is called an input pipe.
1840 An input pipe, instead of writing the name of a replacement file on
1843 If the input pipe does not write any characters on its standard output,
1847 To use an input pipe,
1849 vertical bar (|) to signify that the input preprocessor is an input pipe.
1850 As with non-pipe input preprocessors, the command string must contain one
1851 occurrence of %s, which is replaced with the filename of the input file.
1862 *.Z) uncompress \-c $1 2>/dev/null
1889 if LESSOPEN starts with only one vertical bar, the exit status
1892 When an input pipe is used, a LESSCLOSE postprocessor can be used,
1896 postprocessor is "\-".
1900 the input preprocessor or pipe is not used if
1902 is viewing standard input.
1903 However, if the first character of LESSOPEN is a dash (\-),
1904 the input preprocessor is used on standard input as well as other files.
1907 If standard input is being viewed, the input preprocessor is passed
1910 (|\-) or two vertical bars and a dash (||\-),
1911 the input pipe is used on standard input as well as other files.
1913 the input pipe command.
1916 There are three types of characters in the input file:
1943 Selects a character set appropriate for MS-DOS.
1946 .IP IBM-1047
1949 by setting either LESSCHARSET=IBM-1047 or LC_CTYPE=en_US
1951 .IP koi8-r
1955 .IP utf-8
1956 Selects the UTF-8 encoding of the ISO 10646 character set.
1957 UTF-8 is special in that it supports multi-byte characters in the input file.
1958 It is the only character set that supports multi-byte characters.
1989 IBM-1047 4cbcbc3b9cbccbccbb4c6bcc5b3cbbc4bc4bccbc
1992 koi8-r 8bcccbcc18b95.b128.
1999 but any of the strings "UTF-8", "UTF8", "utf-8" or "utf8"
2001 environment variables, then the default character set is utf-8.
2013 interface is also not available, the default character set is utf-8.
2017 (e.g.\& \(haA for control-A). Caret notation is used only if
2028 printf-style escape sequence (a % followed by x, X, o, d, etc.).
2035 When the character set is utf-8, the LESSUTFBINFMT environment variable
2044 Problematic octets in a UTF-8 file (octets of a truncated sequence,
2045 octets of a complete but non-shortest form sequence, invalid octets,
2048 of how the UTF-8 file is ill-formed.
2050 When the character set is utf-8, in rare cases it may be desirable to
2058 to a comma-separated list of
2067 If there are multiple comma-separated codepoint values,
2074 A wide (2-space) printable character.
2076 A binary (non-printable) character.
2084 E000-F8FF:p,F0000-FFFFD:p,100000-10FFFD:p
2089 The \-P option allows you to tailor the prompt to your preference.
2090 The string given to the \-P option replaces the specified prompt string.
2098 (References to the input file size below refer to the preprocessed size,
2099 if an input preprocessor is being used.)
2101 Replaced by the byte offset into the current input file.
2109 and a "j" means use the "target" line, as specified by the \-j option.
2111 Replaced by the size of the current input file.
2116 Replaced by the page number of a line in the input file.
2119 Replaced by the number of pages in the input file,
2120 or equivalently, the page number of the last line in the input file.
2126 Replaced by the name of the current input file.
2128 Replaced by the last component of the name of the current input file.
2130 Replaced by the shell-escaped name of the current input file.
2135 input files.
2137 Replaced by the line number of a line in the input file.
2140 Replaced by the line number of the last line in the input file.
2142 Replaced by the total number of input files.
2148 Replaced by the percent into the current input file, based on byte offsets.
2151 Replaced by the percent into the current input file, based on line numbers.
2160 However if viewing files via a tags list using the \-t option,
2163 Replaced by the name of the next input file in the list.
2165 If any item is unknown (for example, the file size if input
2177 the colon and the period are included in the string if and only if
2185 True if the size of current input file is known.
2191 True if at end-of-file.
2193 True if there is an input filename
2194 (that is, if input is not a pipe).
2200 True if there is more than one input file.
2202 True if this is the first prompt in a new input file.
2204 True if the percent into the current input file, based on byte offsets,
2207 True if the percent into the current input file, based on line numbers,
2212 True if there is a next input file
2213 (that is, if the current input file is not the last one).
2223 ?f%f:Standard input.
2226 otherwise the string "Standard input".
2228 ?f%f \&.?ltLine %lt:?pt%pt\e%:?btByte %bt:-...
2238 ?n?f%f\ .?m(%T %i of %m)\ ..?e(END)\ ?x-\ Next\e:\ %x..%t
2242 than one input file.
2243 Then, if we are at end-of-file, the string "(END)" is printed
2248 the other two prompts (\-m and \-M respectively).
2249 Each is broken into two lines here for readability only.
2252 ?n?f%f\ .?m(%T\ %i\ of\ %m)\ ..?e(END)\ ?x-\ Next\e:\ %x.:
2255 ?f%f\ .?n?m(%T\ %i\ of\ %m)\ ..?ltlines\ %lt-%lb?L/%L.\ :
2256 byte\ %bB?s/%s.\ .?e(END)\ ?x-\ Next\e:\ %x.:?pB%pB\e%..%t
2262 ?f%f\ .?m(%T\ %i\ of\ %m)\ .?ltlines\ %lt-%lb?L/%L.\ .
2277 line number, followed by the shell-escaped file name.
2298 use of lesskey files (-k and \-\-lesskey-src)
2300 input preprocessor (LESSOPEN environment variable)
2302 log files (s and \-o)
2314 use of tags files (-t)
2316 The LESSSECURE_ALLOW environment variable can be set to a comma-separated list
2344 The \-e option works differently.
2345 If the \-e option is not set,
2347 behaves as if the \-e option were set.
2348 If the \-e option is set,
2350 behaves as if the \-E option were set.
2352 The \-m option works differently.
2353 If the \-m option is not set, the medium prompt is used,
2354 and it is prefixed with the string "\-\-More\-\-".
2355 If the \-m option is set, the short prompt is used.
2357 The \-n option acts like the \-z option.
2358 The normal behavior of the \-n option is unavailable in this mode.
2360 The parameter to the \-p option is taken to be a
2375 over variables defined in the system-wide lesskey file.
2409 A comma-separated list of OSC types which are output directly to the
2410 terminal when \-R is in effect.
2411 By default, only OSC 8 sequences are output directly.
2416 String Terminator (ESC-backslash or BEL)
2422 otherwise only sequences that appear in a prompt string are passed through.
2424 Format for displaying non-printable, non-control characters.
2430 Command line to invoke the (optional) input-postprocessor.
2439 Name of the command used by the \-t option to find global tags.
2447 If set to "\-" or "/dev/null", a history file is not used.
2453 .IP "Windows and MS-DOS"
2470 The value is parsed as if it were the parameter of a \-\-lesskey-content option.
2472 Name of the default system-wide
2476 Name of the default system-wide
2487 Command line to invoke the (optional) input-preprocessor.
2497 Format for displaying non-printable Unicode code points.
2521 Duration (in milliseconds) after starting to read data from the input,
2535 When the \-F option is set,
2542 to ensure that the entire file can be seen when \-F is used.
2554 A space-separated list of command line options.
2557 Options listed in LESS_UNSUPPORT can still be changed by the \- and \-\- commands.
2573 on MS-DOS, Windows, and OS/2 systems).
2596 Copyright (C) 1984-2025 Mark Nudelman
2608 Suite 330, Boston, MA 02111-1307, USA.