SUMMARY OF LESS COMMANDS
Commands marked with * may be preceded by a number, N.
Notes in parentheses indicate the behavior if N is given.
A key preceded by a caret indicates the Ctrl key; thus ^K is ctrl-K.
h H Display this help.
q :q Q :Q ZZ Exit.
---------------------------------------------------------------------------
MOVING
e ^E j ^N CR * Forward one line (or N lines).
y ^Y k ^K ^P * Backward one line (or N lines).
J * Forward one line, but don't stop at end-of-file.
K Y * Backward one line, but don't stop at beginning-of-file.
ESC-j * Forward one file line (or N file lines).
ESC-k * Backward one file line (or N file lines).
f ^F ^V SPACE * Forward one window (or N lines).
b ^B ESC-v * Backward one window (or N lines).
z * Forward one window (and set window to N).
w * Backward one window (and set window to N).
ESC-SPACE * Forward one window, but don't stop at end-of-file.
ESC-b * Backward one window, but don't stop at beginning-of-file.
d ^D * Forward one half-window (and set half-window to N).
u ^U * Backward one half-window (and set half-window to N).
ESC-) RightArrow * Right one half screen width (or N positions).
ESC-( LeftArrow * Left one half screen width (or N positions).
ESC-] ESC-RArrow * Right like ESC-) but stop at longest line.
ESC-} ^RightArrow Right to last column displayed.
ESC-{ ^LeftArrow Left to first column.
F Forward forever; like "tail -f".
ESC-F Like F but stop when search pattern is found.
ESC-f Like F but ring the bell when search pattern is found.
r ^R ^L Repaint screen.
R Repaint screen, discarding buffered input.
---------------------------------------------------
Default "window" is the screen height.
Default "half-window" is half of the screen height.
---------------------------------------------------------------------------
SEARCHING
/pattern * Search forward for (N-th) matching line.
?pattern * Search backward for (N-th) matching line.
n * Repeat previous search (for N-th occurrence).
N * Repeat previous search in reverse direction.
ESC-n * Repeat previous search, spanning files.
ESC-N * Repeat previous search, reverse dir. & spanning files.
^O^N ^On * Search forward for (N-th) OSC8 hyperlink.
^O^P ^Op * Search backward for (N-th) OSC8 hyperlink.
^O^L ^Ol Jump to the currently selected OSC8 hyperlink.
ESC-u Undo (toggle) search highlighting.
ESC-U Clear search highlighting.
&pattern * Display only matching lines.
---------------------------------------------------
Search is case-sensitive unless changed with -i or -I.
A search pattern may begin with one or more of:
^N or ! Search for NON-matching lines.
^E or * Search multiple files (pass thru END OF FILE).
^F or @ Start search at FIRST file (for /) or last file (for ?).
^K Highlight matches, but don't move (KEEP position).
^R Don't use REGULAR EXPRESSIONS.
^S n Search for match in n-th parenthesized subpattern.
^W WRAP search if no match found.
^L Enter next character literally into pattern.
---------------------------------------------------------------------------
JUMPING
g < ESC-< HOME * Go to first line in file (or line N).
G > ESC-> END * Go to last line in file (or line N).
p % * Go to beginning of file (or N percent into file).
t * Go to the (N-th) next tag.
T * Go to the (N-th) previous tag.
{ ( [ * Find close bracket } ) ].
} ) ] * Find open bracket { ( [.
ESC-^F <c1> <c2> * Find close bracket <c2>.
ESC-^B <c1> <c2> * Find open bracket <c1>.
---------------------------------------------------
Each "find close bracket" command goes forward to the close bracket
matching the (N-th) open bracket in the top line.
Each "find open bracket" command goes backward to the open bracket
matching the (N-th) close bracket in the bottom line.
m<letter> * Mark the top line (or line N) with <letter>.
M<letter> * Mark the bottom line (or line N) with <letter>.
'<letter> * Go to a previously marked position (put on position N).
'' * Go to the previous position.
^X^X * Same as '.
ESC-m<letter> Clear a mark.
---------------------------------------------------
A mark is any upper-case or lower-case letter.
Certain marks are predefined:
^ means beginning of the file
$ means end of the file
---------------------------------------------------------------------------
CHANGING FILES
:e [file] Examine a new file.
^X^V Same as :e.
:n * Examine the (N-th) next file from the command line.
:p * Examine the (N-th) previous file from the command line.
:x * Examine the first (or N-th) file from the command line.
^O^O Open the currently selected OSC8 hyperlink.
:d Delete the current file from the command line list.
= ^G :f Print current file name.
---------------------------------------------------------------------------
MISCELLANEOUS COMMANDS
-<flag> Toggle a command line option [see OPTIONS below].
--<name> Toggle a command line option, by name.
_<flag> Display the setting of a command line option.
__<name> Display the setting of an option, by name.
+cmd Execute the less cmd each time a new file is examined.
!command Execute the shell command with $SHELL.
#command Execute the shell command, expanded like a prompt.
|Xcommand Pipe file between current pos & mark X to shell command.
||XYcommand Pipe file between mark X and mark Y to shell command.
s file Save input to a file.
v Edit the current file with $VISUAL or $EDITOR.
V Print version number of "less".
---------------------------------------------------------------------------
OPTIONS
Most options may be changed either on the command line,
or from within less by using the - or -- command.
Options may be given in one of two forms: either a single
character preceded by a -, or a name preceded by --.
-? ........ --help
Display help (from command line).
-a ........ --search-skip-screen
Search skips current screen.
-A ........ --SEARCH-SKIP-SCREEN
Search starts just after target line.
-b [N] .... --buffers=[N]
Number of buffers.
-B ........ --auto-buffers
Don't automatically allocate buffers for pipes.
-c ........ --clear-screen
Repaint by clearing rather than scrolling.
-d ........ --dumb
Dumb terminal.
-D xcolor . --color=xcolor
Set screen colors.
-e -E .... --quit-at-eof --QUIT-AT-EOF
Quit at end of file.
-f ........ --force
Force open non-regular files.
-F ........ --quit-if-one-screen
Quit if entire file fits on first screen.
-g ........ --hilite-search
Highlight only last match for searches.
-G ........ --HILITE-SEARCH
Don't highlight any matches for searches.
-h [N] .... --max-back-scroll=[N]
Backward scroll limit.
-i ........ --ignore-case
Ignore case in searches that do not contain uppercase.
-I ........ --IGNORE-CASE
Ignore case in all searches.
-j [N] .... --jump-target=[N]
Screen position of target lines.
-J ........ --status-column
Display a status column at left edge of screen.
-K ........ --quit-on-intr
Exit less in response to ctrl-C.
-L ........ --no-lessopen
Ignore the LESSOPEN environment variable.
-m -M .... --long-prompt --LONG-PROMPT
Set prompt style.
-n ......... --line-numbers
Suppress line numbers in prompts and messages.
-N ......... --LINE-NUMBERS
Display line number at start of each line.
-o [file] .. --log-file=[file]
Copy to log file (standard input only).
-O [file] .. --LOG-FILE=[file]
Copy to log file (unconditionally overwrite).
-p pattern . --pattern=[pattern]
Start at pattern (from command line).
-P [prompt] --prompt=[prompt]
Define new prompt.
-q -Q .... --quiet --QUIET --silent --SILENT
Quiet the terminal bell.
-r -R .... --raw-control-chars --RAW-CONTROL-CHARS
Output "raw" control characters.
-s ........ --squeeze-blank-lines
Squeeze multiple blank lines.
-S ........ --chop-long-lines
Chop (truncate) long lines rather than wrapping.
-t tag .... --tag=[tag]
Find a tag.
-T [tagsfile] --tag-file=[tagsfile]
Use an alternate tags file.
-u -U .... --underline-special --UNDERLINE-SPECIAL
Change handling of backspaces, tabs and carriage returns.
-V ........ --version
Display the version number of "less".
-w ........ --hilite-unread
Highlight first new line after full screen movement.
-W ........ --HILITE-UNREAD
Highlight first new line after any movement.
-x [N[,...]] --tabs=[N[,...]]
Set tab stops.
-X ........ --no-init
Don't use termcap init/deinit strings.
-y [N] .... --max-forw-scroll=[N]
Forward scroll limit.
-z [N] .... --window=[N]
Set size of window.
-" [c[c]] . --quotes=[c[c]]
Set shell quote characters.
-~ ........ --tilde
Don't display tildes after end of file.
-# [N] .... --shift=[N]
Set horizontal scroll amount (0 = one half screen width).
--autosave=[m/!*]
Actions which cause the history file to be saved.
--emouse=[vscroll,vdrag,hscroll,hdrag,lclick,rclick]
Enable mouse features.
--end-prompt=[string]
String to be printed after erasing the prompt.
--exit-follow-on-close
Exit F command on a pipe when writer closes pipe.
--file-size
Automatically determine the size of the input file.
--follow-name
The F command changes files if the input file is renamed.
--form-feed
Stop scrolling when a form feed character is reached.
--header=[L[,C[,N]]]
Use L lines (starting at line N) and C columns as headers.
--hilite-target
Highlight the target line.
--incsearch
Search file as each pattern character is typed in.
--intr=[C]
Use C instead of ^X to interrupt a read.
--lesskey-context=text
Use lesskey source file contents.
--lesskey-src=file
Use a lesskey source file.
--line-num-width=[N]
Set the width of the -N line number field to N characters.
--match-shift=[N]
Show at least N characters to the left of a search match.
--modelines=[N]
Read N lines from the input file and look for vim modelines.
--mouse
Enable mouse clicking and vertical scrolling.
--no-edit-warn
Don't warn when using v command on a file opened via LESSOPEN.
--no-keypad
Don't send termcap keypad init/deinit strings.
--no-histdups
Remove duplicates from command history.
--no-number-headers
Don't give line numbers to header lines.
--no-paste
Ignore pasted input.
--no-search-header-lines
Searches do not include header lines.
--no-search-header-columns
Searches do not include header columns.
--no-search-headers
Searches do not include header lines or columns.
--no-vbell
Disable the terminal's visual bell.
--redraw-on-quit
Redraw final screen when quitting.
--rscroll=[C]
Set the character used to mark truncated lines.
--save-marks
Retain marks across invocations of less.
--search-options=[EFKNRW-]
Set default options for every search.
--show-preproc-errors
Display a message if preprocessor exits with an error status.
--past-eof
Scrolling commands continue past end of file.
--proc-backspace
Process backspaces for bold/underline.
--PROC-BACKSPACE
Treat backspaces as control characters.
--proc-return
Delete carriage returns before newline.
--PROC-RETURN
Treat carriage returns as control characters.
--proc-tab
Expand tabs to spaces.
--PROC-TAB
Treat tabs as control characters.
--status-col-width=[N]
Set the width of the -J status column to N characters.
--status-line
Highlight or color the entire line containing a mark.
--time-file-size=[N]
Don't take more than N milliseconds for --file-size.
--use-backslash
Subsequent options use backslash as escape char.
--use-color
Enables colored text.
--wheel-lines=[N]
Each click of the mouse wheel moves N lines.
--wordwrap
Wrap lines at spaces.
---------------------------------------------------------------------------
LINE EDITING
These keys can be used to edit text being entered
on the "command line" at the bottom of the screen.
RightArrow ..................... ESC-l ... Move cursor right one character.
LeftArrow ...................... ESC-h ... Move cursor left one character.
ctrl-RightArrow ESC-RightArrow ESC-w ... Move cursor right one word.
ctrl-LeftArrow ESC-LeftArrow ESC-b ... Move cursor left one word.
HOME ........................... ESC-0 ... Move cursor to start of line.
END ............................ ESC-$ ... Move cursor to end of line.
BACKSPACE ................................ Delete char to left of cursor.
DELETE ......................... ESC-x ... Delete char under cursor.
ctrl-BACKSPACE ESC-BACKSPACE ........... Delete word to left of cursor.
ctrl-DELETE .... ESC-DELETE .... ESC-X ... Delete word under cursor.
ctrl-U ......... ESC (MS-DOS only) ....... Delete entire line.
INSERT ......................... ESC-i ... Toggle insert/overwrite mode.
UpArrow ........................ ESC-k ... Retrieve previous command line.
DownArrow ...................... ESC-j ... Retrieve next command line.
TAB ...................................... Complete filename & cycle.
SHIFT-TAB ...................... ESC-TAB Complete filename & reverse cycle.
ctrl-L ................................... Complete filename, list all.
Options (114)
| Option | Description | Source |
|---|---|---|
-?, --help | This option displays a summary of the commands accepted by less (the same as the h command). | help + man |
-a, --search-skip-screen | By default, forward searches start at the top of the displayed screen and backwards searches start at the bottom of the displayed screen (except for repeated searches invoked by the n or N commands,… | help + man |
-A, --SEARCH-SKIP-SCREEN | Causes all forward searches (not just non-repeated searches) to start just after the target line, and all backward searches to start just before the target line. | help + man |
-b N | .... | help |
-B, --auto-buffers | By default, when data is read from standard input or a pipe, buffers are allocated automatically as needed. | help + man |
-c, --clear-screen | Causes full screen repaints to be painted from the top line down. | help + man |
-d, --dumb | The -d option suppresses the error message normally displayed if the terminal is dumb; | help + man |
-D xcolor | . | help |
-e, --quit-at-eof | Causes less to automatically exit the second time it reaches end-of-file. | help + man |
-f, --force | Forces non-regular files to be opened. | help + man |
-F, --quit-if-one-screen | Causes less to automatically exit if the entire file can be displayed on the first screen. | help + man |
-g, --hilite-search | Normally, less will highlight ALL strings which match the last search command. | help + man |
-G, --HILITE-SEARCH | The -G option suppresses all highlighting of strings found by search commands. | help + man |
-h N | .... | help |
-i, --ignore-case | Causes searches to ignore case; | help + man |
-I, --IGNORE-CASE | Like -i, but searches ignore case even if the pattern contains uppercase letters. | help + man |
-j N | .... | help |
-J, --status-column | Displays a status column at the left edge of the screen. | help + man |
-K, --quit-on-intr | Causes less to exit immediately (with status 2) when an interrupt character (usually ^C) is typed. | help + man |
-L, --no-lessopen | Ignore the LESSOPEN environment variable (see the INPUT PREPROCESSOR section below). | help + man |
-m, --long-prompt | Causes less to prompt verbosely (like more(1)), with the percent into the file. | help + man |
-n, --line-numbers ......... | --line-numbers Suppress line numbers in prompts and messages. | help + man |
-N, --LINE-NUMBERS ......... | Causes a line number to be displayed at the beginning of each line in the display. | help + man |
-o file | --log-file=[file] Copy to log file (standard input only). | help |
-O file | --LOG-FILE=[file] Copy to log file (unconditionally overwrite). | help |
-p pattern | --pattern=[pattern] Start at pattern (from command line). | help |
-P prompt | changes the message printed by the = command. | help + man |
-q, --quiet, --silent | Causes moderately "quiet" operation: the terminal bell is not rung if an attempt is made to scroll past the end of the file or before the beginning of the file. | help + man |
-r, --raw-control-chars | Causes "raw" control characters to be displayed. | help + man |
-s, --squeeze-blank-lines | Causes consecutive blank lines to be squeezed into a single blank line. | help + man |
-S, --chop-long-lines | Causes lines longer than the screen width to be chopped (truncated) rather than wrapped. | help + man |
-t tag | .... | help |
-u, --underline-special | Causes backspaces and carriage returns to be treated as printable characters; | help + man |
-V, --version | Displays the version number of less. | help + man |
-w, --hilite-unread | Temporarily highlights the first "new" line after a movement of a full page. | help + man |
-W, --HILITE-UNREAD | Like -w, but temporarily highlights the first new line after any movement command larger than one line. | help + man |
-x N | --tabs=[N[,...]] Set tab stops. | help |
-X, --no-init | Disables sending the termcap initialization and deinitialization strings to the terminal. | help + man |
-y N | .... | help |
-z N | .... | help |
-#, --shift N | Specifies the default number of positions to scroll horizontally in the RIGHTARROW and LEFTARROW commands. | help + man |
--autosave m/!* | Normally, the history file is saved only when less exits. | help + man |
--emouse vscroll | features is a comma-separated list of mouse features to be enabled, selected from this list: | help + man |
--end-prompt string | Specifies a string which is printed immediately after the prompt is erased. | help + man |
--exit-follow-on-close | When using the "F" command on a pipe, less will automatically stop waiting for more data when the input side of the pipe is closed. | help + man |
--file-size | If --file-size is specified, less will determine the size of the file immediately after opening the file. | help + man |
--follow-name | Normally, if the input file is renamed while an F command is executing, less will continue to display the contents of the original file despite its name change. | help + man |
--form-feed | When scrolling forward or backward in the file, stop if a line beginning with a form feed character (^L) is reached. | help + man |
--header L | Sets the number of header lines and columns displayed on the screen. | help + man |
--hilite-target | Highlights the "target" line, as specified by the -j option. | help + man |
--incsearch | Search file as each pattern character is typed in. | help + man |
--intr C | Use the character c instead of ^X to interrupt a read when the "Waiting for data" message is displayed. | help + man |
--lesskey-context text | Use lesskey source file contents. | help |
--lesskey-src file | Causes less to open and interpret the named file as a lesskey(5) source file. | help + man |
--line-num-width N | Sets the minimum width of the line number field when the -N option is in effect to n characters. | help + man |
--match-shift N | When -S is in effect, if a search match is not visible because it is shifted to the left or right of the currently visible screen, the text will horizontally shift to ensure that the search match is… | help + man |
--modelines N | Before displaying a file, less will read the first n lines to try to find a vim-compatible modeline. | help + man |
--mouse | Enabling --mouse is the same as --emouse=vmove,click. | help + man |
--no-edit-warn | Don't print a warning message when using the v command on a file which was opened using a LESSOPEN preprocessor (see the INPUT PREPROCESSOR section below). | help + man |
--no-keypad | Disables sending the keypad initialization and deinitialization strings to the terminal. | help + man |
--no-histdups | This option changes the behavior so that if a search string or file name is typed in, and the same string is already in the history list, the existing copy is removed from the history list before the… | help + man |
--no-number-headers | Header lines (defined via the --header option) are not assigned line numbers. | help + man |
--no-paste | If the terminal supports xterm-compatible "bracketed paste", any text pasted into less is ignored, except that one line of text may be pasted into the command line at the bottom of the screen (search… | help + man |
--no-search-header-lines | Searches do not include header lines, but still include header columns. | help + man |
--no-search-header-columns | Searches do not include header columns, but still include header lines. | help + man |
--no-search-headers | Searches do not include header lines or header columns. | help + man |
--no-vbell | Disables the terminal's visual bell. | help + man |
--redraw-on-quit | When quitting, after sending the terminal deinitialization string, redraws the entire last screen. | help + man |
--rscroll C | This option changes the character used to mark truncated lines. | help + man |
--save-marks | Save marks in the history file, so marks are retained across different invocations of less. | help + man |
--search-options EFKNRW- | Set default options for every search. | help + man |
--show-preproc-errors | If a LESSOPEN preprocessor produces data, then exits with a non-zero exit code, less will display a warning. | help + man |
--past-eof | Normally, scrolling commands (other than J, K, ESC-SPACE and ESC-b) stop scrolling when end-of-file is reached scrolling forward, or beginning-of-file is reached scrolling backward. | help + man |
--proc-backspace | If set, backspaces are handled as if neither the -u option nor the -U option were set. | help + man |
--PROC-BACKSPACE | If set, backspaces are handled as if the -U option were set; | help + man |
--proc-return | If set, carriage returns are handled as if neither the -u option nor the -U option were set. | help + man |
--PROC-RETURN | If set, carriage returns are handled as if the -U option were set; | help + man |
--proc-tab | If set, tabs are handled as if the -U option were not set. | help + man |
--PROC-TAB | If set, tabs are handled as if the -U option were set; | help + man |
--status-col-width N | Sets the width of the status column when the -J option is in effect. | help + man |
--status-line | If a line is marked, the entire line (rather than just the status column) is highlighted. | help + man |
--time-file-size N | When the --file-size option is given, don't spend more than ms milliseconds finding the file size. | help + man |
--use-backslash | This option changes the interpretations of options which follow this one. | help + man |
--use-color | Enables colored text in various places. | help + man |
--wheel-lines N | Set the number of lines or columns to scroll when the mouse wheel is scrolled and the --mouse or --emouse option is in effect. | help + man |
--wordwrap | When the -S option is not in use, wrap each line at a space or tab if possible, so that a word is not split between two lines. | help + man |
-bn, --buffers n | Specifies the amount of buffer space less will use for each file, in units of kilobytes (1024 bytes). (in the manual page but not in --help) | man |
-C, --CLEAR-SCREEN | Same as -c, for compatibility with older versions of less. (in the manual page but not in --help) | man |
-Dxcolor, --color xcolor | Changes the color of different parts of the displayed text. (in the manual page but not in --help) | man |
-E, --QUIT-AT-EOF | Causes less to automatically exit the first time it reaches end-of-file. (in the manual page but not in --help) | man |
-hn, --max-back-scroll n | Specifies a maximum number of lines to scroll backward. (in the manual page but not in --help) | man |
-jn, --jump-target n | Specifies a line on the screen where the "target" line is to be positioned. (in the manual page but not in --help) | man |
--lesskey-content text | Causes less to interpret the specified text as the contents of a lesskey(5) source file. (in the manual page but not in --help) | man |
-M, --LONG-PROMPT | Causes less to prompt even more verbosely than more(1). (in the manual page but not in --help) | man |
-ofilename, --log-file filename | Causes less to copy its input to the named file as it is being viewed. (in the manual page but not in --help) | man |
-Ofilename, --LOG-FILE filename | The -O option is like -o, but it will overwrite an existing file without asking for confirmation. (in the manual page but not in --help) | man |
-ppattern, --pattern pattern | The -p option on the command line is equivalent to specifying +/pattern; (in the manual page but not in --help) | man |
-Pprompt, --prompt prompt | Provides a way to tailor the three prompt styles to your own preference. (in the manual page but not in --help) | man |
-Ps | followed by a string changes the default (short) prompt to that string. (in the manual page but not in --help) | man |
-Pm | changes the medium (-m) prompt. (in the manual page but not in --help) | man |
-PM | changes the long (-M) prompt. (in the manual page but not in --help) | man |
-Ph | changes the prompt for the help screen. (in the manual page but not in --help) | man |
-Pw | changes the message printed while waiting for data (in the "F" command). (in the manual page but not in --help) | man |
-Q, --QUIET, --SILENT | Causes totally "quiet" operation: the terminal bell is never rung. (in the manual page but not in --help) | man |
-R, --RAW-CONTROL-CHARS | Like -r, but only a limited set of escape sequences are output in "raw" form. (in the manual page but not in --help) | man |
-ttag, --tag tag | The -t option, followed immediately by a TAG, will view the file containing that tag. (in the manual page but not in --help) | man |
-Ttagsfile, --tag-file tagsfile | Specifies a tags file to be used instead of "tags". (in the manual page but not in --help) | man |
-U, --UNDERLINE-SPECIAL | Causes backspaces, tabs, carriage returns and "formatting characters" (as defined by Unicode) to be treated as control characters; (in the manual page but not in --help) | man |
-xn, --tabs n | Sets tab stops. (in the manual page but not in --help) | man |
-yn, --max-forw-scroll n | Specifies a maximum number of lines to scroll forward. (in the manual page but not in --help) | man |
--tilde | Normally, lines after end of file are displayed as a single tilde (~). (in the manual page but not in --help) | man |
--cmd commands | The specified string is taken to be an initial command to less. (in the manual page but not in --help) | man |
--MOUSE | Like --mouse with --rmouse. (in the manual page but not in --help) | man |
--rmouse | Reverses the normal direction of scrolling when mouse scrolling is enabled via --emouse=vscroll or --emouse=hscroll. (in the manual page but not in --help) | man |