=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/less/less.hlp,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- src/usr.bin/less/less.hlp 1996/09/21 05:39:45 1.1 +++ src/usr.bin/less/less.hlp 2003/04/13 18:26:25 1.2 @@ -1,27 +1,36 @@ - SUMMARY OF COMMANDS + SSUUMMMMAARRYY OOFF CCOOMMMMAANNDDSS Commands marked with * may be preceded by a number, _N. Notes in parentheses indicate the behavior if _N is given. h H Display this help. - q :q :Q ZZ Exit. + q :q Q :Q ZZ Exit. + --------------------------------------------------------------------------- - e ^E j ^N CR * Forward one line (or _N lines). - y ^Y k ^K ^P * Backward one line (or _N lines). + MMOOVVIINNGG + + e ^E j ^N CR * Forward one line (or _N lines). + y ^Y k ^K ^P * Backward one line (or _N 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. 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 * Left one half screen width (or _N positions). + ESC-( LeftArrow * Right one half screen width (or _N positions). F Forward forever; like "tail -f". 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. - --------------------------------------------------- + --------------------------------------------------------------------------- + + SSEEAARRCCHHIINNGG + /_p_a_t_t_e_r_n * Search forward for (_N-th) matching line. ?_p_a_t_t_e_r_n * Search backward for (_N-th) matching line. n * Repeat previous search (for _N-th occurrence). @@ -31,79 +40,181 @@ ESC-u Undo (toggle) search highlighting. --------------------------------------------------- Search patterns may be modified by one or more of: - ! search for NON-matching lines. - * search multiple files. - @ start search at first file (for /) or last file (for ?). - --------------------------------------------------- + ^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. + --------------------------------------------------------------------------- + + JJUUMMPPIINNGG + g < ESC-< * Go to first line in file (or line _N). G > ESC-> * Go to last line in file (or line _N). p % * Go to beginning of file (or _N percent into file). - { * Go to the } matching the (_N-th) { in the top line. - } * Go to the { matching the (_N-th) } in the bottom line. - ( * Go to the ) matching the (_N-th) ( in the top line. - ) * Go to the ( matching the (_N-th) ) in the bottom line. - [ * Go to the ] matching the (_N-th) [ in the top line. - ] * Go to the [ matching the (_N-th) ] in the bottom line. - ESC-^F _<_c_1_> _<_c_2_> * Go to the _c_1 matching the (_N-th) _c_2 in the top line - ESC-^B _<_c_1_> _<_c_2_> * Go to the _c_2 matching the (_N-th) _c_1 in the bottom line. + t * Go to the (_N-th) next tag. + T * Go to the (_N-th) previous tag. + { ( [ * Find close bracket } ) ]. + } ) ] * Find open bracket { ( [. + ESC-^F _<_c_1_> _<_c_2_> * Find close bracket _<_c_2_>. + ESC-^B _<_c_1_> _<_c_2_> * Find open bracket _<_c_1_> + --------------------------------------------------- + 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_<_l_e_t_t_e_r_> Mark the current position with . '_<_l_e_t_t_e_r_> Go to a previously marked position. '' Go to the previous position. ^X^X Same as '. + --------------------------------------------------- + A mark is any upper-case or lower-case letter. + Certain marks are predefined: + ^ means beginning of the file + $ means end of the file + --------------------------------------------------------------------------- + CCHHAANNGGIINNGG FFIILLEESS + :e [_f_i_l_e] 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. + :d Delete the current file from the command line list. = ^G :f Print current file name. - V Print version number of "less". + --------------------------------------------------------------------------- - -_<_f_l_a_g_> Toggle a command line flag [see FLAGS below]. - __<_f_l_a_g_> Display the setting of a command line flag. + MMIISSCCEELLLLAANNEEOOUUSS CCOOMMMMAANNDDSS + + -_<_f_l_a_g_> Toggle a command line option [see OPTIONS below]. + --_<_n_a_m_e_> Toggle a command line option, by name. + __<_f_l_a_g_> Display the setting of a command line option. + ___<_n_a_m_e_> Display the setting of an option, by name. +_c_m_d Execute the less cmd each time a new file is examined. - !_c_o_m_m_a_n_d Passes the command to $SHELL to be executed. + !_c_o_m_m_a_n_d Execute the shell command with $SHELL. |XX_c_o_m_m_a_n_d Pipe file between current pos & mark XX to shell command. v Edit the current file with $VISUAL or $EDITOR. - --------------------------------------------------- - FLAGS + V Print version number of "less". + --------------------------------------------------------------------------- - Most flags may be changed either on the command line, - or from within less by using the - command. + OOPPTTIIOONNSS - -? Display help (from command line). - -a Forward search skips current screen. - -b [_N] Number of buffers. - -B Don't automatically allocate buffers for pipes. - -c -C Repaint by scrolling/clearing. - -d Dumb terminal. - -e -E Quit at end of file. - -f Force open non-regular files. - -g Don't highlight matches for previous search pattern. - -G Highlight ALL matches for previous search pattern. - -h [_N] Backward scroll limit. - -i Ignore case in searches. - -I Ignore case in searches and in search patterns. - -j [_N] Screen position of target lines. - -k [_f_i_l_e] Use a lesskey file. - -m -M Set prompt style. - -n -N Use line numbers. - -o [_f_i_l_e] Log file. - -O [_f_i_l_e] Log file (unconditionally overwrite). - -p [_p_a_t_t_e_r_n] Start at pattern (from command line). - -P [_p_r_o_m_p_t] Define new prompt. - -q -Q Quiet the terminal bell. - -r Output "raw" control characters. - -s Squeeze multiple blank lines. - -S Chop long lines. - -t [_t_a_g] Find a tag. - -T [_t_a_g_s_f_i_l_e] Use an alternate tags file. - -u -U Change handling of backspaces. - -V Display the version number of "less". - -w Display ~ for lines after end-of-file. - -x [_N] Set tab stops. - -X Don't use termcap init/deinit strings. - -y [_N] Forward scroll limit. - -z [_N] Set size of window. + 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 preceeded by --. + + -? ........ --help + Display help (from command line). + -a ........ --search-skip-screen + Forward search skips current screen. + -b [_N] .... --buffers=[_N] + Number of buffers. + -B ........ --auto-buffers + Don't automatically allocate buffers for pipes. + -c -C .... --clear-screen --CLEAR-SCREEN + Repaint by scrolling/clearing. + -d ........ --dumb + Dumb terminal. + -D [_x_n_._n] . --color=_x_n_._n + Set screen colors. (MS-DOS only) + -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 [_f_i_l_e] . --lesskey-file=[_f_i_l_e] + Use a lesskey file. + -L ........ --no-lessopen + Ignore the LESSOPEN environment variable. + -m -M .... --long-prompt --LONG-PROMPT + Set prompt style. + -n -N .... --line-numbers --LINE-NUMBERS + Use line numbers. + -o [_f_i_l_e] . --log-file=[_f_i_l_e] + Copy to log file (standard input only). + -O [_f_i_l_e] . --LOG-FILE=[_f_i_l_e] + Copy to log file (unconditionally overwrite). + -p [_p_a_t_t_e_r_n] --pattern=[_p_a_t_t_e_r_n] + Start at pattern (from command line). + -P [_p_r_o_m_p_t] --prompt=[_p_r_o_m_p_t] + 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 long lines. + -t [_t_a_g] .. --tag=[_t_a_g] + Find a tag. + -T [_t_a_g_s_f_i_l_e] --tag-file=[_t_a_g_s_f_i_l_e] + Use an alternate tags file. + -u -U .... --underline-special --UNDERLINE-SPECIAL + Change handling of backspaces. + -V ........ --version + Display the version number of "less". + -w ........ --hilite-unread + Highlight first new line after forward-screen. + -W ........ --HILITE-UNREAD + Highlight first new line after any forward movement. + -x [_N[,...]] --tabs=[_N[,...]] + Set tab stops. + -X ........ --no-init + Don't use termcap init/deinit strings. + --no-keypad + Don't use termcap keypad 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] + Horizontal scroll amount (0 = one half screen width) + + --------------------------------------------------------------------------- + + LLIINNEE EEDDIITTIINNGG + + 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. + CNTL-RightArrow ESC-RightArrow ESC-w Move cursor right one word. + CNTL-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. + CNTL-BACKSPACE ESC-BACKSPACE Delete word to left of cursor. + CNTL-DELETE ESC-DELETE ESC-X Delete word under cursor. + CNTL-U ESC (MS-DOS only) Delete entire line. + 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. + CNTL-L Complete filename, list all.