vendor/less/v563vendor/less

1 files changed, 84 insertions, 83 deletions

diff --git a/less.nro b/less.nro
index 0aa8b7863330..70f99ce6f286 100644
--- a/less.nro
+++ b/less.nro
@@ -1,4 +1,5 @@
-.TH LESS 1 "Version 551: 11 Jun 2019"
+'\" t
+.TH LESS 1 "Version 563: 13 Jun 2020"
 .SH NAME
 less \- opposite of more
 .SH SYNOPSIS
@@ -21,19 +22,18 @@ less \- opposite of more
 .B "     [\-# \fIshift\/\fP] [+[+]\fIcmd\/\fP] [\-\-] [\fIfilename\/\fP]..."
 .br
 (See the OPTIONS section for alternate option syntax with long option names.)
-
+.
 .SH DESCRIPTION
 .I Less
 is a program similar to
-.I more
-(1), but which allows backward movement
+.IR more (1),
+but which allows backward movement
 in the file as well as forward movement.
 Also,
 .I less
 does not have to read the entire input file before starting,
 so with large input files it starts up faster than text editors like
-.I vi
-(1).
+.IR vi (1).
 .I Less
 uses termcap (or terminfo on some systems),
 so it can run on a variety of terminals.
@@ -48,7 +48,7 @@ and
 Commands may be preceded by a decimal number,
 called N in the descriptions below.
 The number is used by some commands, as indicated.
-
+.
 .SH COMMANDS
 In the following descriptions, ^X means control-X.
 ESC stands for the ESCAPE key; for example ESC-v means the
@@ -229,7 +229,7 @@ that is, do a simple textual comparison.
 .RE
 .IP ?pattern
 Search backward in the file for the N-th line containing the pattern.
-The search starts at the last line displayed 
+The search starts at the last line displayed
 (but see the \-a and \-j options, which change this).
 .sp
 Certain characters are special as in the / command:
@@ -376,7 +376,7 @@ this will reset the option to the "opposite" of its default setting
 and print a message describing the new setting.
 This does not work for numeric or string-valued options.
 .IP \-\-!
-Like the \-! command, but takes a long option name
+Like the \-!\& command, but takes a long option name
 rather than a single option letter.
 .IP _
 (Underscore.)
@@ -405,7 +405,7 @@ Exits
 The following
 four
 commands may or may not be valid, depending on your particular installation.
-.PP
+.
 .IP v
 Invokes an editor to edit the current file being viewed.
 The editor is taken from the environment variable VISUAL if defined,
@@ -425,7 +425,7 @@ On MS-DOS and OS/2 systems, the shell is the normal command processor.
 .IP "| <m> shell-command"
 <m> represents any mark letter.
 Pipes a section of the input file to the given shell command.
-The section of the file to be piped is between the position marked by 
+The section of the file to be piped is between the position marked by
 the letter and the current screen.
 The entire current screen is included, regardless of whether the
 marked position is before or after the current screen.
@@ -434,7 +434,7 @@ If <m> is \&.\& or newline, the current screen is piped.
 .IP "s filename"
 Save the input to a file.
 This only works if the input is a pipe, not an ordinary file.
-.PP
+.
 .SH OPTIONS
 Command line options are described below.
 Most options may be changed while
@@ -518,7 +518,7 @@ This was the default behavior in less versions prior to 441.
 Specifies the amount of buffer space
 .I less
 will use for each file, in units of kilobytes (1024 bytes).
-By default 64\ K of buffer space is used for each file
+By default 64\ KB of buffer space is used for each file
 (unless the file is a pipe; see the \-B option).
 The \-b option specifies instead that \fIn\fP kilobytes of
 buffer space should be used for each file.
@@ -530,7 +530,7 @@ buffers are allocated automatically as needed.
 If a large amount of data is read from the pipe, this can cause
 a large amount of memory to be allocated.
 The \-B option disables this automatic allocation of buffers for pipes,
-so that only 64\ K
+so that only 64\ KB
 (or the amount of space specified by the \-b option)
 is used for the pipe.
 Warning: use of \-B can result in erroneous display, since only the
@@ -563,8 +563,9 @@ A single number \fIN\fP is the same as \fIN.M\fP,
 where \fIM\fP is the normal background color.
 The color may start or end with \fBu\fP to use underline (with the normal
 color, if by itself), if the system supports it (Windows only).
-\fBx\fP may also be \fBa\fP to toggle strict ANSI sequence rendering (SGR mode).
-
+\fBx\fP may also be \fBa\fP to toggle strict ANSI sequence rendering
+(SGR mode).
+.
 .IP "\-e or \-\-quit-at-eof"
 Causes
 .I less
@@ -654,8 +655,8 @@ The status column is also used if the \-w or \-W option is in effect.
 Causes
 .I less
 to open and interpret the named file as a
-.I lesskey
-(1) file.
+.IR lesskey (1)
+file.
 Multiple \-k options may be specified.
 If the LESSKEY or LESSKEY_SYSTEM environment variable is set, or
 if a lesskey file is found in a standard place (see KEY BINDINGS),
@@ -746,7 +747,7 @@ to that string.
  \-Ph changes the prompt for the help screen.
  \-P= changes the message printed by the = command.
  \-Pw changes the message printed while waiting for data (in the F command).
-
+.sp 1
 All prompt strings consist of a sequence of
 letters and special escape sequences.
 See the section on PROMPTS for more details.
@@ -762,7 +763,7 @@ The default is to ring the terminal bell in all such cases.
 .IP "\-Q or \-\-QUIET or \-\-SILENT"
 Causes totally "quiet" operation:
 the terminal bell is never rung.
-If the terminal has a "visual bell", it is used in all cases 
+If the terminal has a "visual bell", it is used in all cases
 where the terminal bell would have been rung.
 .IP "\-r or \-\-raw-control-chars"
 Causes "raw" control characters to be displayed.
@@ -804,7 +805,7 @@ output.
 Causes lines longer than the screen width to be
 chopped (truncated) rather than wrapped.
 That is, the portion of a long line that does not fit in
-the screen width is not shown.
+the screen width is not displayed until you press RIGHT-ARROW.
 The default is to wrap long lines; that is, display the remainder
 on the next line.
 .IP "\-t\fItag\fP or \-\-tag=\fItag\fP"
@@ -813,12 +814,12 @@ will edit the file containing that tag.
 For this to work, tag information must be available;
 for example, there may be a file in the current directory called "tags",
 which was previously built by
-.I ctags
-(1) or an equivalent command.
+.IR ctags (1)
+or an equivalent command.
 If the environment variable LESSGLOBALTAGS is set, it is taken to be
 the name of a command compatible with
-.I global
-(1), and that command is executed to find the tag.
+.IR global (1),
+and that command is executed to find the tag.
 (See http://www.gnu.org/software/global/global.html).
 The \-t option may also be specified from within
 .I less
@@ -870,7 +871,7 @@ If only one \fIn\fP is specified, tab stops are set at multiples of \fIn\fP.
 If multiple values separated by commas are specified, tab stops
 are set at those positions, and then continue with the same spacing as the
 last two.
-For example, \fI-x9,17\fP will set tabs at positions 9, 17, 25, 33, etc.
+For example, \fI\-x9,17\fP will set tabs at positions 9, 17, 25, 33, etc.
 The default for \fIn\fP is 8.
 .IP "\-X or \-\-no-init"
 Disables sending the termcap initialization and deinitialization strings
@@ -944,15 +945,15 @@ will display the contents of that new file.
 Enables mouse input:
 scrolling the mouse wheel down moves forward in the file,
 scrolling the mouse wheel up moves backwards in the file,
-and clicking the mouse sets the "#" mark to the line 
+and clicking the mouse sets the "#" mark to the line
 where the mouse is clicked.
-The number of lines to scroll when the wheel is moved 
+The number of lines to scroll when the wheel is moved
 can be set by the \-\-wheel-lines option.
 Mouse input works only on terminals which support X11 mouse reporting,
-and on the Windows version of 
+and on the Windows version of
 .IR less .
 .IP "\-\-MOUSE"
-Like \-\-mouse, except the direction scrolled 
+Like \-\-mouse, except the direction scrolled
 on mouse wheel movement is reversed.
 .IP "\-\-no-keypad"
 Disables sending the keypad initialization and deinitialization strings
@@ -961,7 +962,7 @@ This is sometimes useful if the keypad strings make the numeric
 keypad behave in an undesirable manner.
 .IP "\-\-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, 
+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 new one is added.
 Thus, a given string will appear only once in the history list.
 Normally, a string may appear multiple times.
@@ -969,7 +970,7 @@ Normally, a string may appear multiple times.
 This option changes the character used to mark truncated lines.
 It may begin with a two-character attribute indicator like LESSBINFMT does.
 If there is no attribute indicator, standout is used.
-If set to "-", truncated lines are not marked.
+If set to "\-", truncated lines are not marked.
 .IP "\-\-save-marks"
 Save marks in the history file, so marks are retained
 across different invocations of \fIless\fP.
@@ -1001,7 +1002,7 @@ If the option starts with ++, the initial command applies to
 every file being viewed, not just the first one.
 The + command described previously
 may also be used to set (or change) an initial command for every file.
-
+.
 .SH "LINE EDITING"
 When entering command line at the bottom of the screen
 (for example, a filename for the :e command,
@@ -1069,13 +1070,12 @@ If you have changed your line-kill character in Unix to something
 other than ^U, that character is used instead of ^U.
 .IP "^G"
 Delete the entire command line and return to the main prompt.
-
+.
 .SH "KEY BINDINGS"
 You may define your own
 .I less
 commands by using the program
-.I lesskey
-(1)
+.IR lesskey (1)
 to create a lesskey file.
 This file specifies a set of command keys and an action
 associated with each key.
@@ -1125,7 +1125,7 @@ was built with a different sysconf directory than /usr/local/etc,
 that directory is where the sysless file is found.)
 On MS-DOS and Windows systems, the system-wide lesskey file is c:\e_sysless.
 On OS/2 systems, the system-wide lesskey file is c:\esysless.ini.
-
+.
 .SH "INPUT PREPROCESSOR"
 You may define an "input preprocessor" for
 .IR less .
@@ -1294,7 +1294,7 @@ Similarly, if the first two characters of LESSOPEN are vertical bar and dash
 the input pipe is used on standard input as well as other files.
 Again, in this case the dash is not considered to be part of
 the input pipe command.
-
+.
 .SH "NATIONAL CHARACTER SETS"
 There are three types of characters in the input file:
 .IP "normal characters"
@@ -1349,7 +1349,7 @@ In this case, the environment variable LESSCHARDEF can be used
 to define a character set.
 It should be set to a string where each character in the string represents
 one character in the character set.
-The character "." is used for a normal character, "c" for control,
+The character ".\&" is used for a normal character, "c" for control,
 and "b" for binary.
 A decimal number may be used for repetition.
 For example, "bccc4b.\&" would mean character 0 is binary,
@@ -1361,26 +1361,22 @@ represent any real character set.)
 .PP
 This table shows the value of LESSCHARDEF which is equivalent
 to each of the possible values for LESSCHARSET:
-.sp
-	ascii\ 	8bcccbcc18b95.b
-.br
-	dos\ \ \ 	8bcccbcc12bc5b95.b.
-.br
-	ebcdic	5bc6bcc7bcc41b.9b7.9b5.b..8b6.10b6.b9.7b
-.br
-	\ \ \ \ \ \ 	9.8b8.17b3.3b9.7b9.8b8.6b10.b.b.b.
-.br
-	IBM-1047	4cbcbc3b9cbccbccbb4c6bcc5b3cbbc4bc4bccbc
-.br
-	\ \ \ \ \ \ 	191.b
-.br
-	iso8859	8bcccbcc18b95.33b.
-.br
-	koi8-r	8bcccbcc18b95.b128.
-.br
-	latin1	8bcccbcc18b95.33b.
-.br
-	next\ \ 	8bcccbcc18b95.bb125.bb
+.
+.RS 5m
+.TS
+l l.
+ascii	8bcccbcc18b95.b
+dos	8bcccbcc12bc5b95.b.
+ebcdic	5bc6bcc7bcc41b.9b7.9b5.b..8b6.10b6.b9.7b
+	9.8b8.17b3.3b9.7b9.8b8.6b10.b.b.b.
+IBM-1047	4cbcbc3b9cbccbccbb4c6bcc5b3cbbc4bc4bccbc
+	191.b
+iso8859	8bcccbcc18b95.33b.
+koi8-r	8bcccbcc18b95.b128.
+latin1	8bcccbcc18b95.33b.
+next	8bcccbcc18b95.bb125.bb
+.TE
+.RE
 .PP
 If neither LESSCHARSET nor LESSCHARDEF is set,
 but any of the strings "UTF-8", "UTF8", "utf-8" or "utf8"
@@ -1429,11 +1425,11 @@ setting ("*x") so specifying one will affect both;
 LESSUTFBINFMT is read after LESSBINFMT so its setting, if any,
 will have priority.
 Problematic octets in a UTF-8 file (octets of a truncated sequence,
-octets of a complete but non-shortest form sequence, illegal octets,
+octets of a complete but non-shortest form sequence, invalid octets,
 and stray trailing octets)
 are displayed individually using LESSBINFMT so as to facilitate diagnostic
 of how the UTF-8 file is ill-formed.
-
+.
 .SH "PROMPTS"
 The \-P option allows you to tailor the prompt to your preference.
 The string given to the \-P option replaces the specified prompt string.
@@ -1500,7 +1496,8 @@ Causes any trailing spaces to be removed.
 Usually used at the end of the string, but may appear anywhere.
 .IP "%T"
 Normally expands to the word "file".
-However if viewing files via a tags list using the \-t option, it expands to the word "tag".
+However if viewing files via a tags list using the \-t option,
+it expands to the word "tag".
 .IP "%x"
 Replaced by the name of the next input file in the list.
 .PP
@@ -1620,7 +1617,7 @@ line number, followed by the shell-escaped file name.
 If your editor does not accept the "+linenumber" syntax, or has other
 differences in invocation syntax, the LESSEDIT variable can be
 changed to modify this default.
-
+.
 .SH SECURITY
 When the environment variable LESSSECURE is set to 1,
 .I less
@@ -1641,14 +1638,14 @@ log files
 use of lesskey files
 .IP "\-t"
 use of tags files
-.IP " "
+.IP
 metacharacters in filenames, such as *
-.IP " "
+.IP
 filename completion (TAB, ^L)
 .RE
 .PP
 Less can also be compiled to be permanently in "secure" mode.
-
+.
 .SH "COMPATIBILITY WITH MORE"
 If the environment variable LESS_IS_MORE is set to 1,
 or if the program is invoked via a file link named "more",
@@ -1666,7 +1663,7 @@ behaves as if the \-E option were set.
 .PP
 The \-m option works differently.
 If the \-m option is not set, the medium prompt is used,
-and it is prefixed with the string "--More--".
+and it is prefixed with the string "\-\-More\-\-".
 If the \-m option is set, the short prompt is used.
 .PP
 The \-n option acts like the \-z option.
@@ -1678,12 +1675,12 @@ command rather than a search pattern.
 .PP
 The LESS environment variable is ignored,
 and the MORE environment variable is used in its place.
-
+.
 .SH "ENVIRONMENT VARIABLES"
 Environment variables may be specified either in the system environment
 as usual, or in a
-.I lesskey
-(1) file.
+.IR lesskey (1)
+file.
 If environment variables are defined in more than one place,
 variables defined in a local lesskey file take precedence over
 variables defined in the system environment, which take precedence
@@ -1738,8 +1735,8 @@ See discussion under PROMPTS.
 .IP LESSGLOBALTAGS
 Name of the command used by the \-t option to find global tags.
 Normally should be set to "global" if your system has the
-.I global
-(1) command.  If not set, global tags are not used.
+.IR global (1)
+command.  If not set, global tags are not used.
 .IP LESSHISTFILE
 Name of the history file used to remember search commands and
 shell commands between invocations of
@@ -1752,9 +1749,13 @@ on OS/2 systems.
 The maximum number of commands to save in the history file.
 The default is 100.
 .IP LESSKEY
-Name of the default lesskey(1) file.
+Name of the default
+.IR lesskey (1)
+file.
 .IP LESSKEY_SYSTEM
-Name of the default system-wide lesskey(1) file.
+Name of the default system-wide
+.IR lesskey (1)
+file.
 .IP LESSMETACHARS
 List of characters which are considered "metacharacters" by the shell.
 .IP LESSMETAESCAPE
@@ -1773,8 +1774,8 @@ String to be appended to a directory name in filename completion.
 Format for displaying non-printable Unicode code points.
 .IP LESS_IS_MORE
 Emulate the
-.I more
-(1) command.
+.IR more (1)
+command.
 .IP LINES
 Sets the number of lines on the screen.
 Takes precedence over the number of lines specified by the TERM variable.
@@ -1791,19 +1792,19 @@ compatible mode.
 User's search path (used to find a lesskey file
 on MS-DOS and OS/2 systems).
 .IP SHELL
-The shell used to execute the ! command, as well as to expand filenames.
+The shell used to execute the !\& command, as well as to expand filenames.
 .IP TERM
 The type of terminal on which
 .I less
 is being run.
 .IP VISUAL
 The name of the editor (used for the v command).
-
+.
 .SH "SEE ALSO"
-lesskey(1)
-
+.BR lesskey (1)
+.
 .SH COPYRIGHT
-Copyright (C) 1984-2019  Mark Nudelman
+Copyright (C) 1984-2020  Mark Nudelman
 .PP
 less is part of the GNU project and is free software.
 You can redistribute it and/or modify it
@@ -1823,9 +1824,9 @@ less is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 or FITNESS FOR A PARTICULAR PURPOSE.
 See the GNU General Public License for more details.
-
+.
 .SH AUTHOR
-.PP
+.
 Mark Nudelman
 .br
 Report bugs at https://github.com/gwsw/less/issues.