VI(1)                      POSIX Programmer's Manual                     VI(1)



PPRROOLLOOGG
       This manual page is part of the POSIX Programmer's Manual.  The OS
       implementation of this interface may differ (consult the corresponding
       OS manual page for details of OS behavior), or the interface may not be
       implemented on OS.

NNAAMMEE
       vi -- screen-oriented (visual) display editor

SSYYNNOOPPSSIISS
       vi [[-rR]] [[-c _c_o_m_m_a_n_d]] [[-t _t_a_g_s_t_r_i_n_g]] [[-w _s_i_z_e]] [[_f_i_l_e...]]

DDEESSCCRRIIPPTTIIOONN
       This utility shall be provided on systems that both support the User
       Portability Utilities option and define the POSIX2_CHAR_TERM symbol.
       On other systems it is optional.

       The _v_i (visual) utility is a screen-oriented text editor. Only the open
       and visual modes of the editor are described in POSIX.1-2008; see the
       line editor _e_x for additional editing capabilities used in _v_i.  The
       user can switch back and forth between _v_i and _e_x and execute _e_x
       commands from within _v_i.

       This reference page uses the term _e_d_i_t _b_u_f_f_e_r to describe the current
       working text. No specific implementation is implied by this term. All
       editing changes are performed on the edit buffer, and no changes to it
       shall affect any file until an editor command writes the file.

       When using _v_i, the terminal screen acts as a window into the editing
       buffer. Changes made to the editing buffer shall be reflected in the
       screen display; the position of the cursor on the screen shall indicate
       the position within the editing buffer.

       Certain terminals do not have all the capabilities necessary to support
       the complete _v_i definition. When these commands cannot be supported on
       such terminals, this condition shall not produce an error message such
       as ``not an editor command'' or report a syntax error. The
       implementation may either accept the commands and produce results on
       the screen that are the result of an unsuccessful attempt to meet the
       requirements of this volume of POSIX.1-2017 or report an error
       describing the terminal-related deficiency.

OOPPTTIIOONNSS
       The _v_i utility shall conform to the Base Definitions volume of
       POSIX.1-2017, _S_e_c_t_i_o_n _1_2_._2, _U_t_i_l_i_t_y _S_y_n_t_a_x _G_u_i_d_e_l_i_n_e_s, except that ''++''
       may be recognized as an option delimiter as well as ''--''.

       The following options shall be supported:

       --cc _c_o_m_m_a_n_d
                 See the _e_x command description of the --cc option.

       --rr        See the _e_x command description of the --rr option.

       --RR        See the _e_x command description of the --RR option.

       --tt _t_a_g_s_t_r_i_n_g
                 See the _e_x command description of the --tt option.

       --ww _s_i_z_e   See the _e_x command description of the --ww option.

OOPPEERRAANNDDSS
       See the OPERANDS section of the _e_x command for a description of the
       operands supported by the _v_i command.

SSTTDDIINN
       If standard input is not a terminal device, the results are undefined.
       The standard input consists of a series of commands and input text, as
       described in the EXTENDED DESCRIPTION section.

       If a read from the standard input returns an error, or if the editor
       detects an end-of-file condition from the standard input, it shall be
       equivalent to a SIGHUP asynchronous event.

IINNPPUUTT FFIILLEESS
       See the INPUT FILES section of the _e_x command for a description of the
       input files supported by the _v_i command.

EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
       See the ENVIRONMENT VARIABLES section of the _e_x command for the
       environment variables that affect the execution of the _v_i command.

AASSYYNNCCHHRROONNOOUUSS EEVVEENNTTSS
       See the ASYNCHRONOUS EVENTS section of the _e_x for the asynchronous
       events that affect the execution of the _v_i command.

SSTTDDOOUUTT
       If standard output is not a terminal device, undefined results occur.

       Standard output may be used for writing prompts to the user, for
       informational messages, and for writing lines from the file.

SSTTDDEERRRR
       If standard output is not a terminal device, undefined results occur.

       The standard error shall be used only for diagnostic messages.

OOUUTTPPUUTT FFIILLEESS
       See the OUTPUT FILES section of the _e_x command for a description of the
       output files supported by the _v_i command.

EEXXTTEENNDDEEDD DDEESSCCRRIIPPTTIIOONN
       If the terminal does not have the capabilities necessary to support an
       unspecified portion of the _v_i definition, implementations shall start
       initially in _e_x mode or open mode. Otherwise, after initialization, _v_i
       shall be in command mode; text input mode can be entered by one of
       several commands used to insert or change text. In text input mode,
       <ESC> can be used to return to command mode; other uses of <ESC> are
       described later in this section; see _T_e_r_m_i_n_a_t_e _C_o_m_m_a_n_d _o_r _I_n_p_u_t _M_o_d_e.

   IInniittiiaalliizzaattiioonn iinn eexx aanndd vvii
       See _I_n_i_t_i_a_l_i_z_a_t_i_o_n _i_n _e_x _a_n_d _v_i for a description of _e_x and _v_i
       initialization for the _v_i utility.

   CCoommmmaanndd DDeessccrriippttiioonnss iinn vvii
       The following symbols are used in this reference page to represent
       arguments to commands.

       _b_u_f_f_e_r  See the description of _b_u_f_f_e_r in the EXTENDED DESCRIPTION
               section of the _e_x utility; see _C_o_m_m_a_n_d _D_e_s_c_r_i_p_t_i_o_n_s _i_n _e_x.

               In open and visual mode, when a command synopsis shows both
               [_b_u_f_f_e_r] and [_c_o_u_n_t] preceding the command name, they can be
               specified in either order.

       _c_o_u_n_t   A positive integer used as an optional argument to most
               commands, either to give a repeat count or as a size. This
               argument is optional and shall default to 1 unless otherwise
               specified.

               The Synopsis lines for the _v_i commands <control>-G,
               <control>-L, <control>-R, <control>-], %%, &&, ^^, DD, mm, MM, QQ, uu,
               UU, and ZZZZ do not have _c_o_u_n_t as an optional argument.
               Regardless, it shall not be an error to specify a _c_o_u_n_t to
               these commands, and any specified _c_o_u_n_t shall be ignored.

       _m_o_t_i_o_n  An optional trailing argument used by the !!, <<, >>, cc, dd, and yy
               commands, which is used to indicate the region of text that
               shall be affected by the command. The motion can be either one
               of the command characters repeated or one of several other _v_i
               commands (listed in the following table). Each of the
               applicable commands specifies the region of text matched by
               repeating the command; each command that can be used as a
               motion command specifies the region of text it affects.

               Commands that take _m_o_t_i_o_n arguments operate on either lines or
               characters, depending on the circumstances. When operating on
               lines, all lines that fall partially or wholly within the text
               region specified for the command shall be affected. When
               operating on characters, only the exact characters in the
               specified text region shall be affected. Each motion command
               specifies this individually.

               When commands that may be motion commands are not used as
               motion commands, they shall set the current position to the
               current line and column as specified.

               The following commands shall be valid cursor motion commands:


                   <apostrophe>       (    -    j    H
                   <carriage-return>  )    $    k    L
                   <comma>            [[   %    l    M
                   <control>-H        ]]   _    n    N
                   <control>-N        {    ;    t    T
                   <control>-P        }    ?    w    W
                   <grave-accent>     ^    b    B
                   <newline>          +    e    E
                   <space>            |    f    F
                   <zero>             /    h    G

               Any _c_o_u_n_t that is specified to a command that has an associated
               motion command shall be applied to the motion command. If a
               _c_o_u_n_t is applied to both the command and its associated motion
               command, the effect shall be multiplicative.

       The following symbols are used in this section to specify locations in
       the edit buffer:

       _c_u_r_r_e_n_t _c_h_a_r_a_c_t_e_r
               The character that is currently indicated by the cursor.

       _e_n_d _o_f _a _l_i_n_e
               The point located between the last non-<newline> (if any) and
               the terminating <newline> of a line. For an empty line, this
               location coincides with the beginning of the line.

       _e_n_d _o_f _t_h_e _e_d_i_t _b_u_f_f_e_r
               The location corresponding to the end of the last line in the
               edit buffer.

       The following symbols are used in this section to specify command
       actions:

       _b_i_g_w_o_r_d In the POSIX locale, _v_i shall recognize four kinds of _b_i_g_w_o_r_d_s:

                1. A maximal sequence of non-<blank> characters preceded and
                   followed by <blank> characters or the beginning or end of a
                   line or the edit buffer

                2. One or more sequential blank lines

                3. The first character in the edit buffer

                4. The last non-<newline> in the edit buffer

       _w_o_r_d    In the POSIX locale, _v_i shall recognize five kinds of words:

                1. A maximal sequence of letters, digits, and underscores,
                   delimited at both ends by:

                   --  Characters other than letters, digits, or underscores

                   --  The beginning or end of a line

                   --  The beginning or end of the edit buffer

                2. A maximal sequence of characters other than letters,
                   digits, underscores, or <blank> characters, delimited at
                   both ends by:

                   --  A letter, digit, underscore

                   --  <blank> characters

                   --  The beginning or end of a line

                   --  The beginning or end of the edit buffer

                3. One or more sequential blank lines

                4. The first character in the edit buffer

                5. The last non-<newline> in the edit buffer

       _s_e_c_t_i_o_n _b_o_u_n_d_a_r_y
               A _s_e_c_t_i_o_n _b_o_u_n_d_a_r_y is one of the following:

                1. A line whose first character is a <form-feed>

                2. A line whose first character is an open curly brace (''{{'')

                3. A line whose first character is a <period> and whose second
                   and third characters match a two-character pair in the
                   sseeccttiioonnss edit option (see _e_x)

                4. A line whose first character is a <period> and whose only
                   other character matches the first character of a two-
                   character pair in the sseeccttiioonnss edit option, where the
                   second character of the two-character pair is a <space>

                5. The first line of the edit buffer

                6. The last line of the edit buffer if the last line of the
                   edit buffer is empty or if it is a ]]]] or }} command;
                   otherwise, the last non-<newline> of the last line of the
                   edit buffer

       _p_a_r_a_g_r_a_p_h _b_o_u_n_d_a_r_y
               A _p_a_r_a_g_r_a_p_h _b_o_u_n_d_a_r_y is one of the following:

                1. A section boundary

                2. A line whose first character is a <period> and whose second
                   and third characters match a two-character pair in the
                   ppaarraaggrraapphhss edit option (see _e_x)

                3. A line whose first character is a <period> and whose only
                   other character matches the first character of a two-
                   character pair in the _p_a_r_a_g_r_a_p_h_s edit option, where the
                   second character of the two-character pair is a <space>

                4. One or more sequential blank lines

       _r_e_m_e_m_b_e_r_e_d _s_e_a_r_c_h _d_i_r_e_c_t_i_o_n
               See the description of _r_e_m_e_m_b_e_r_e_d _s_e_a_r_c_h _d_i_r_e_c_t_i_o_n in _e_x.

       _s_e_n_t_e_n_c_e _b_o_u_n_d_a_r_y
               A _s_e_n_t_e_n_c_e _b_o_u_n_d_a_r_y is one of the following:

                1. A paragraph boundary

                2. The first non-<blank> that occurs after a paragraph
                   boundary

                3. The first non-<blank> that occurs after a <period> (''..''),
                   <exclamation-mark> (''!!''), or <question-mark> (''??''),
                   followed by two <space> characters or the end of a line;
                   any number of closing parenthesis (''))''), closing brackets
                   ('']]''), double-quote (''""''), or single-quote (<apostrophe>)
                   characters can appear between the punctuation mark and the
                   two <space> characters or end-of-line

       In the remainder of the description of the _v_i utility, the term
       ``buffer line'' refers to a line in the edit buffer and the term
       ``display line'' refers to the line or lines on the display screen used
       to display one buffer line. The term ``current line'' refers to a
       specific ``buffer line''.

       If there are display lines on the screen for which there are no
       corresponding buffer lines because they correspond to lines that would
       be after the end of the file, they shall be displayed as a single
       <tilde> (''~~'') character, plus the terminating <newline>.

       The last line of the screen shall be used to report errors or display
       informational messages. It shall also be used to display the input for
       ``line-oriented commands'' (//, ??, ::, and !!).  When a line-oriented
       command is executed, the editor shall enter text input mode on the last
       line on the screen, using the respective command characters as prompt
       characters. (In the case of the !!  command, the associated motion shall
       be entered by the user before the editor enters text input mode.) The
       line entered by the user shall be terminated by a <newline>, a
       non-<control>-V-escaped <carriage-return>, or unescaped <ESC>.  It is
       unspecified if more characters than require a display width minus one
       column number of screen columns can be entered.

       If any command is executed that overwrites a portion of the screen
       other than the last line of the screen (for example, the _e_x ssuussppeenndd or
       !!  commands), other than the _e_x sshheellll command, the user shall be
       prompted for a character before the screen is refreshed and the edit
       session continued.

       <tab> characters shall take up the number of columns on the screen set
       by the ttaabbssttoopp edit option (see _e_x), unless there are less than that
       number of columns before the display margin that will cause the
       displayed line to be folded; in this case, they shall only take up the
       number of columns up to that boundary.

       The cursor shall be placed on the current line and relative to the
       current column as specified by each command described in the following
       sections.

       In open mode, if the current line is not already displayed, then it
       shall be displayed.

       In visual mode, if the current line is not displayed, then the lines
       that are displayed shall be expanded, scrolled, or redrawn to cause an
       unspecified portion of the current line to be displayed. If the screen
       is redrawn, no more than the number of display lines specified by the
       value of the wwiinnddooww edit option shall be displayed (unless the current
       line cannot be completely displayed in the number of display lines
       specified by the wwiinnddooww edit option) and the current line shall be
       positioned as close to the center of the displayed lines as possible
       (within the constraints imposed by the distance of the line from the
       beginning or end of the edit buffer). If the current line is before the
       first line in the display and the screen is scrolled, an unspecified
       portion of the current line shall be placed on the first line of the
       display. If the current line is after the last line in the display and
       the screen is scrolled, an unspecified portion of the current line
       shall be placed on the last line of the display.

       In visual mode, if a line from the edit buffer (other than the current
       line) does not entirely fit into the lines at the bottom of the display
       that are available for its presentation, the editor may choose not to
       display any portion of the line. The lines of the display that do not
       contain text from the edit buffer for this reason shall each consist of
       a single ''@@'' character.

       In visual mode, the editor may choose for unspecified reasons to not
       update lines in the display to correspond to the underlying edit buffer
       text. The lines of the display that do not correctly correspond to text
       from the edit buffer for this reason shall consist of a single ''@@''
       character (plus the terminating <newline>), and the <control>-R command
       shall cause the editor to update the screen to correctly represent the
       edit buffer.

       Open and visual mode commands that set the current column set it to a
       column position in the display, and not a character position in the
       line. In this case, however, the column position in the display shall
       be calculated for an infinite width display; for example, the column
       related to a character that is part of a line that has been folded onto
       additional screen lines will be offset from the display line column
       where the buffer line begins, not from the beginning of a particular
       display line.

       The display cursor column in the display is based on the value of the
       current column, as follows, with each rule applied in turn:

        1. If the current column is after the last display line column used by
           the displayed line, the display cursor column shall be set to the
           last display line column occupied by the last non-<newline> in the
           current line; otherwise, the display cursor column shall be set to
           the current column.

        2. If the character of which some portion is displayed in the display
           line column specified by the display cursor column requires more
           than a single display line column:

            a. If in text input mode, the display cursor column shall be
               adjusted to the first display line column in which any portion
               of that character is displayed.

            b. Otherwise, the display cursor column shall be adjusted to the
               last display line column in which any portion of that character
               is displayed.

       The current column shall not be changed by these adjustments to the
       display cursor column.

       If an error occurs during the parsing or execution of a _v_i command:

        *  The terminal shall be alerted. Execution of the _v_i command shall
           stop, and the cursor (for example, the current line and column)
           shall not be further modified.

        *  Unless otherwise specified by the following command sections, it is
           unspecified whether an informational message shall be displayed.

        *  Any partially entered _v_i command shall be discarded.

        *  If the _v_i command resulted from a mmaapp expansion, all characters
           from that mmaapp expansion shall be discarded, except as otherwise
           specified by the mmaapp command (see _e_x).

        *  If the _v_i command resulted from the execution of a buffer, no
           further commands caused by the execution of the buffer shall be
           executed.

   PPaaggee BBaacckkwwaarrddss
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-B

       If in open mode, the <control>-B command shall behave identically to
       the zz command. Otherwise, if the current line is the first line of the
       edit buffer, it shall be an error.

       If the wwiinnddooww edit option is less than 3, display a screen where the
       last line of the display shall be some portion of:


           (_c_u_r_r_e_n_t _f_i_r_s_t _l_i_n_e) -1

       otherwise, display a screen where the first line of the display shall
       be some portion of:


           (_c_u_r_r_e_n_t _f_i_r_s_t _l_i_n_e) - _c_o_u_n_t x ((window edit option) -2)

       If this calculation would result in a line that is before the first
       line of the edit buffer, the first line of the display shall display
       some portion of the first line of the edit buffer.

       _C_u_r_r_e_n_t _l_i_n_e: If no lines from the previous display remain on the
       screen, set to the last line of the display; otherwise, set to (_l_i_n_e -
       the number of new lines displayed on this screen).

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   SSccrroollll FFoorrwwaarrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-D

       If the current line is the last line of the edit buffer, it shall be an
       error.

       If no _c_o_u_n_t is specified, _c_o_u_n_t shall default to the _c_o_u_n_t associated
       with the previous <control>-D or <control>-U command. If there was no
       previous <control>-D or <control>-U command, _c_o_u_n_t shall default to the
       value of the ssccrroollll edit option.

       If in open mode, write lines starting with the line after the current
       line, until _c_o_u_n_t lines or the last line of the file have been written.

       _C_u_r_r_e_n_t _l_i_n_e: If the current line + _c_o_u_n_t is past the last line of the
       edit buffer, set to the last line of the edit buffer; otherwise, set to
       the current line + _c_o_u_n_t.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   SSccrroollll FFoorrwwaarrdd bbyy LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-E

       Display the line count lines after the last line currently displayed.

       If the last line of the edit buffer is displayed, it shall be an error.
       If there is no line _c_o_u_n_t lines after the last line currently
       displayed, the last line of the display shall display some portion of
       the last line of the edit buffer.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged if the previous current character is displayed;
       otherwise, set to the first line displayed.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   PPaaggee FFoorrwwaarrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-F

       If in open mode, the <control>-F command shall behave identically to
       the zz command. Otherwise, if the current line is the last line of the
       edit buffer, it shall be an error.

       If the wwiinnddooww edit option is less than 3, display a screen where the
       first line of the display shall be some portion of:


           (_c_u_r_r_e_n_t _l_a_s_t _l_i_n_e) +1

       otherwise, display a screen where the first line of the display shall
       be some portion of:


           (_c_u_r_r_e_n_t _f_i_r_s_t _l_i_n_e) + _c_o_u_n_t x ((window edit option) -2)

       If this calculation would result in a line that is after the last line
       of the edit buffer, the last line of the display shall display some
       portion of the last line of the edit buffer.

       _C_u_r_r_e_n_t _l_i_n_e: If no lines from the previous display remain on the
       screen, set to the first line of the display; otherwise, set to (_l_i_n_e +
       the number of new lines displayed on this screen).

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   DDiissppllaayy IInnffoorrmmaattiioonn
       _S_y_n_o_p_s_i_s:

                     <control>-G

       This command shall be equivalent to the _e_x ffiillee command.

   MMoovvee CCuurrssoorr BBaacckkwwaarrddss
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-H
                     [[_c_o_u_n_t]] h
                     the current _e_r_a_s_e character (see stty)

       If there are no characters before the current character on the current
       line, it shall be an error. If there are less than _c_o_u_n_t previous
       characters on the current line, _c_o_u_n_t shall be adjusted to the number
       of previous characters on the line.

       If used as a motion command:

        1. The text region shall be from the character before the starting
           cursor up to and including the _c_o_u_n_tth character before the
           starting cursor.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to (_c_o_l_u_m_n - the number of columns occupied by
       _c_o_u_n_t characters ending with the previous current column).

   MMoovvee DDoowwnn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <newline>
                     [[_c_o_u_n_t]] <control>-J
                     [[_c_o_u_n_t]] <control>-M
                     [[_c_o_u_n_t]] <control>-N
                     [[_c_o_u_n_t]] j
                     [[_c_o_u_n_t]] <carriage-return>
                     [[_c_o_u_n_t]] +

       If there are less than _c_o_u_n_t lines after the current line in the edit
       buffer, it shall be an error.

       If used as a motion command:

        1. The text region shall include the starting line and the next _c_o_u_n_t
           - 1 lines.

        2. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to _c_u_r_r_e_n_t _l_i_n_e+ _c_o_u_n_t.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank> for the <carriage-return>,
       <control>-M, and ++ commands; otherwise, unchanged.

   CClleeaarr aanndd RReeddiissppllaayy
       _S_y_n_o_p_s_i_s:

                     <control>-L

       If in open mode, clear the screen and redisplay the current line.
       Otherwise, clear and redisplay the screen.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   MMoovvee UUpp
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-P
                     [[_c_o_u_n_t]] k
                     [[_c_o_u_n_t]] -

       If there are less than _c_o_u_n_t lines before the current line in the edit
       buffer, it shall be an error.

       If used as a motion command:

        1. The text region shall include the starting line and the previous
           _c_o_u_n_t lines.

        2. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to _c_u_r_r_e_n_t _l_i_n_e - _c_o_u_n_t.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank> for the -- command; otherwise,
       unchanged.

   RReeddrraaww SSccrreeeenn
       _S_y_n_o_p_s_i_s:

                     <control>-R

       If any lines have been deleted from the display screen and flagged as
       deleted on the terminal using the @@ convention (see the beginning of
       the EXTENDED DESCRIPTION section), they shall be redisplayed to match
       the contents of the edit buffer.

       It is unspecified whether lines flagged with @@ because they do not fit
       on the terminal display shall be affected.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   SSccrroollll BBaacckkwwaarrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-U

       If the current line is the first line of the edit buffer, it shall be
       an error.

       If no _c_o_u_n_t is specified, _c_o_u_n_t shall default to the _c_o_u_n_t associated
       with the previous <control>-D or <control>-U command. If there was no
       previous <control>-D or <control>-U command, _c_o_u_n_t shall default to the
       value of the ssccrroollll edit option.

       _C_u_r_r_e_n_t _l_i_n_e: If _c_o_u_n_t is greater than the current line, set to 1;
       otherwise, set to the current line - _c_o_u_n_t.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   SSccrroollll BBaacckkwwaarrdd bbyy LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <control>-Y

       Display the line _c_o_u_n_t lines before the first line currently displayed.

       If the current line is the first line of the edit buffer, it shall be
       an error. If this calculation would result in a line that is before the
       first line of the edit buffer, the first line of the display shall
       display some portion of the first line of the edit buffer.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged if the previous current character is displayed;
       otherwise, set to the first line displayed.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   EEddiitt tthhee AAlltteerrnnaattee FFiillee
       _S_y_n_o_p_s_i_s:

                     <control>-^

       This command shall be equivalent to the _e_x eeddiitt command, with the
       alternate pathname as its argument.

   TTeerrmmiinnaattee CCoommmmaanndd oorr IInnppuutt MMooddee
       _S_y_n_o_p_s_i_s:

                     <ESC>

       If a partial _v_i command (as defined by at least one, non-_c_o_u_n_t
       character) has been entered, discard the _c_o_u_n_t and the command
       character(s).

       Otherwise, if no command characters have been entered, and the <ESC>
       was the result of a map expansion, the terminal shall be alerted and
       the <ESC> character shall be discarded, but it shall not be an error.

       Otherwise, it shall be an error.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   SSeeaarrcchh ffoorr ttaaggssttrriinngg
       _S_y_n_o_p_s_i_s:

                     <control>-]

       If the current character is not a word or <blank>, it shall be an
       error.

       This command shall be equivalent to the _e_x ttaagg command, with the
       argument to that command defined as follows.

       If the current character is a <blank>:

        1. Skip all <blank> characters after the cursor up to the end of the
           line.

        2. If the end of the line is reached, it shall be an error.

       Then, the argument to the _e_x ttaagg command shall be the current character
       and all subsequent characters, up to the first non-word character or
       the end of the line.

   MMoovvee CCuurrssoorr FFoorrwwaarrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] <space>
                     [[_c_o_u_n_t]] l  (ell)

       If there are less than _c_o_u_n_t non-<newline> characters after the cursor
       on the current line, _c_o_u_n_t shall be adjusted to the number of
       non-<newline> characters after the cursor on the line.

       If used as a motion command:

        1. If the current or _c_o_u_n_tth character after the cursor is the last
           non-<newline> in the line, the text region shall be comprised of
           the current character up to and including the last non-<newline> in
           the line. Otherwise, the text region shall be from the current
           character up to, but not including, the _c_o_u_n_tth character after the
           cursor.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       If there are no non-<newline> characters after the current character on
       the current line, it shall be an error.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column that displays any portion of the
       _c_o_u_n_tth character after the current character.

   RReeppllaaccee TTeexxtt wwiitthh RReessuullttss ffrroomm SShheellll CCoommmmaanndd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] ! _m_o_t_i_o_n _s_h_e_l_l_-_c_o_m_m_a_n_d_s <newline>

       If the motion command is the !!  command repeated:

        1. If the edit buffer is empty and no _c_o_u_n_t was supplied, the command
           shall be the equivalent of the _e_x ::rreeaadd !!  command, with the text
           input, and no text shall be copied to any buffer.

        2. Otherwise:

            a. If there are less than _c_o_u_n_t -1 lines after the current line in
               the edit buffer, it shall be an error.

            b. The text region shall be from the current line up to and
               including the next _c_o_u_n_t -1 lines.

       Otherwise, the text region shall be the lines in which any character of
       the text region specified by the motion command appear.

       Any text copied to a buffer shall be in line mode.

       This command shall be equivalent to the _e_x !!  command for the specified
       lines.

   MMoovvee CCuurrssoorr ttoo EEnndd--ooff--LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] $

       It shall be an error if there are less than (_c_o_u_n_t -1) lines after the
       current line in the edit buffer.

       If used as a motion command:

        1. If _c_o_u_n_t is 1:

            a. It shall be an error if the line is empty.

            b. Otherwise, the text region shall consist of all characters from
               the starting cursor to the last non-<newline> in the line,
               inclusive, and any text copied to a buffer shall be in
               character mode.

        2. Otherwise, if the starting cursor position is at or before the
           first non-<blank> in the line, the text region shall consist of the
           current and the next _c_o_u_n_t -1 lines, and any text saved to a buffer
           shall be in line mode.

        3. Otherwise, the text region shall consist of all characters from the
           starting cursor to the last non-<newline> in the line that is _c_o_u_n_t
           -1 lines forward from the current line, and any text copied to a
           buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the _c_u_r_r_e_n_t _l_i_n_e + _c_o_u_n_t-1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: The current column is set to the last display line
       column of the last non-<newline> in the line, or column position 1 if
       the line is empty.

       The current column shall be adjusted to be on the last display line
       column of the last non-<newline> of the current line as subsequent
       commands change the current line, until a command changes the current
       column.

   MMoovvee ttoo MMaattcchhiinngg CChhaarraacctteerr
       _S_y_n_o_p_s_i_s:

                     %

       If the character at the current position is not a parenthesis, bracket,
       or curly brace, search forward in the line to the first one of those
       characters. If no such character is found, it shall be an error.

       The matching character shall be the parenthesis, bracket, or curly
       brace matching the parenthesis, bracket, or curly brace, respectively,
       that was at the current position or that was found on the current line.

       Matching shall be determined as follows, for an open parenthesis:

        1. Set a counter to 1.

        2. Search forwards until a parenthesis is found or the end of the edit
           buffer is reached.

        3. If the end of the edit buffer is reached, it shall be an error.

        4. If an open parenthesis is found, increment the counter by 1.

        5. If a close parenthesis is found, decrement the counter by 1.

        6. If the counter is zero, the current character is the matching
           character.

       Matching for a close parenthesis shall be equivalent, except that the
       search shall be backwards, from the starting character to the beginning
       of the buffer, a close parenthesis shall increment the counter by 1,
       and an open parenthesis shall decrement the counter by 1.

       Matching for brackets and curly braces shall be equivalent, except that
       searching shall be done for open and close brackets or open and close
       curly braces. It is implementation-defined whether other characters are
       searched for and matched as well.

       If used as a motion command:

        1. If the matching cursor was after the starting cursor in the edit
           buffer, and the starting cursor position was at or before the first
           non-<blank> non-<newline> in the starting line, and the matching
           cursor position was at or after the last non-<blank> non-<newline>
           in the matching line, the text region shall consist of the current
           line to the matching line, inclusive, and any text copied to a
           buffer shall be in line mode.

        2. If the matching cursor was before the starting cursor in the edit
           buffer, and the starting cursor position was at or after the last
           non-<blank> non-<newline> in the starting line, and the matching
           cursor position was at or before the first non-<blank>
           non-<newline> in the matching line, the text region shall consist
           of the current line to the matching line, inclusive, and any text
           copied to a buffer shall be in line mode.

        3. Otherwise, the text region shall consist of the starting character
           to the matching character, inclusive, and any text copied to a
           buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line where the matching character is located.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column where any portion of the
       matching character is displayed.

   RReeppeeaatt SSuubbssttiittuuttiioonn
       _S_y_n_o_p_s_i_s:

                     &

       Repeat the previous substitution command. This command shall be
       equivalent to the _e_x && command with the current line as its addresses,
       and without _o_p_t_i_o_n_s, _c_o_u_n_t, or _f_l_a_g_s.

   RReettuurrnn ttoo PPrreevviioouuss CCoonntteexxtt aatt BBeeggiinnnniinngg ooff LLiinnee
       _S_y_n_o_p_s_i_s:

                     ' _c_h_a_r_a_c_t_e_r

       It shall be an error if there is no line in the edit buffer marked by
       _c_h_a_r_a_c_t_e_r.

       If used as a motion command:

        1. If the starting cursor is after the marked cursor, then the
           locations of the starting cursor and the marked cursor in the edit
           buffer shall be logically swapped.

        2. The text region shall consist of the starting line up to and
           including the marked line, and any text copied to a buffer shall be
           in line mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line referenced by the mark.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   RReettuurrnn ttoo PPrreevviioouuss CCoonntteexxtt
       _S_y_n_o_p_s_i_s:

                     ` _c_h_a_r_a_c_t_e_r

       It shall be an error if the marked line is no longer in the edit
       buffer. If the marked line no longer contains a character in the saved
       numbered character position, it shall be as if the marked position is
       the first non-<blank>.

       If used as a motion command:

        1. It shall be an error if the marked cursor references the same
           character in the edit buffer as the starting cursor.

        2. If the starting cursor is after the marked cursor, then the
           locations of the starting cursor and the marked cursor in the edit
           buffer shall be logically swapped.

        3. If the starting line is empty or the starting cursor is at or
           before the first non-<blank> non-<newline> of the starting line,
           and the marked cursor line is empty or the marked cursor references
           the first character of the marked cursor line, the text region
           shall consist of all lines containing characters from the starting
           cursor to the line before the marked cursor line, inclusive, and
           any text copied to a buffer shall be in line mode.

        4. Otherwise, if the marked cursor line is empty or the marked cursor
           references a character at or before the first non-<blank>
           non-<newline> of the marked cursor line, the region of text shall
           be from the starting cursor to the last non-<newline> of the line
           before the marked cursor line, inclusive, and any text copied to a
           buffer shall be in character mode.

        5. Otherwise, the region of text shall be from the starting cursor
           (inclusive), to the marked cursor (exclusive), and any text copied
           to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line referenced by the mark.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       character referenced by the mark is displayed.

   RReettuurrnn ttoo PPrreevviioouuss SSeeccttiioonn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] [[

       Move the cursor backward through the edit buffer to the first character
       of the previous section boundary, _c_o_u_n_t times.

       If used as a motion command:

        1. If the starting cursor was at the first character of the starting
           line or the starting line was empty, and the first character of the
           boundary was the first character of the boundary line, the text
           region shall consist of the current line up to and including the
           line where the _c_o_u_n_tth next boundary starts, and any text copied to
           a buffer shall be in line mode.

        2. If the boundary was the last line of the edit buffer or the last
           non-<newline> of the last line of the edit buffer, the text region
           shall consist of the last character in the edit buffer up to and
           including the starting character, and any text saved to a buffer
           shall be in character mode.

        3. Otherwise, the text region shall consist of the starting character
           up to but not including the first character in the _c_o_u_n_tth next
           boundary, and any text copied to a buffer shall be in character
           mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line where the _c_o_u_n_tth next boundary in the
       edit buffer starts.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       first character of the _c_o_u_n_tth next boundary is displayed, or column
       position 1 if the line is empty.

   MMoovvee ttoo NNeexxtt SSeeccttiioonn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] ]]

       Move the cursor forward through the edit buffer to the first character
       of the next section boundary, _c_o_u_n_t times.

       If used as a motion command:

        1. If the starting cursor was at the first character of the starting
           line or the starting line was empty, and the first character of the
           boundary was the first character of the boundary line, the text
           region shall consist of the current line up to and including the
           line where the _c_o_u_n_tth previous boundary starts, and any text
           copied to a buffer shall be in line mode.

        2. If the boundary was the first line of the edit buffer, the text
           region shall consist of the first character in the edit buffer up
           to but not including the starting character, and any text copied to
           a buffer shall be in character mode.

        3. Otherwise, the text region shall consist of the first character in
           the _c_o_u_n_tth previous section boundary up to but not including the
           starting character, and any text copied to a buffer shall be in
           character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line where the _c_o_u_n_tth previous boundary in
       the edit buffer starts.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       first character of the _c_o_u_n_tth previous boundary is displayed, or
       column position 1 if the line is empty.

   MMoovvee ttoo FFiirrsstt NNoonn--<<bbllaannkk>> PPoossiittiioonn oonn CCuurrrreenntt LLiinnee
       _S_y_n_o_p_s_i_s:

                     ^

       If used as a motion command:

        1. If the line has no non-<blank> non-<newline> characters, or if the
           cursor is at the first non-<blank> non-<newline> of the line, it
           shall be an error.

        2. If the cursor is before the first non-<blank> non-<newline> of the
           line, the text region shall be comprised of the current character,
           up to, but not including, the first non-<blank> non-<newline> of
           the line.

        3. If the cursor is after the first non-<blank> non-<newline> of the
           line, the text region shall be from the character before the
           starting cursor up to and including the first non-<blank>
           non-<newline> of the line.

        4. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   CCuurrrreenntt aanndd LLiinnee AAbboovvee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] _

       If there are less than _c_o_u_n_t -1 lines after the current line in the
       edit buffer, it shall be an error.

       If used as a motion command:

        1. If _c_o_u_n_t is less than 2, the text region shall be the current line.

        2. Otherwise, the text region shall include the starting line and the
           next _c_o_u_n_t -1 lines.

        3. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to current line + _c_o_u_n_t -1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   MMoovvee BBaacckk ttoo BBeeggiinnnniinngg ooff SSeenntteennccee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] (

       Move backward to the beginning of a sentence. This command shall be
       equivalent to the [[[[ command, with the exception that sentence
       boundaries shall be used instead of section boundaries.

   MMoovvee FFoorrwwaarrdd ttoo BBeeggiinnnniinngg ooff SSeenntteennccee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] )

       Move forward to the beginning of a sentence. This command shall be
       equivalent to the ]]]] command, with the exception that sentence
       boundaries shall be used instead of section boundaries.

   MMoovvee BBaacckk ttoo PPrreecceeddiinngg PPaarraaggrraapphh
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] {

       Move back to the beginning of the preceding paragraph. This command
       shall be equivalent to the [[[[ command, with the exception that
       paragraph boundaries shall be used instead of section boundaries.

   MMoovvee FFoorrwwaarrdd ttoo NNeexxtt PPaarraaggrraapphh
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] }

       Move forward to the beginning of the next paragraph. This command shall
       be equivalent to the ]]]] command, with the exception that paragraph
       boundaries shall be used instead of section boundaries.

   MMoovvee ttoo SSppeecciiffiicc CCoolluummnn PPoossiittiioonn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] |

       For the purposes of this command, lines that are too long for the
       current display and that have been folded shall be treated as having a
       single, 1-based, number of columns.

       If there are less than _c_o_u_n_t columns in which characters from the
       current line are displayed on the screen, _c_o_u_n_t shall be adjusted to be
       the last column in which any portion of the line is displayed on the
       screen.

       If used as a motion command:

        1. If the line is empty, or the cursor character is the same as the
           character on the _c_o_u_n_tth column of the line, it shall be an error.

        2. If the cursor is before the _c_o_u_n_tth column of the line, the text
           region shall be comprised of the current character, up to but not
           including the character on the _c_o_u_n_tth column of the line.

        3. If the cursor is after the _c_o_u_n_tth column of the line, the text
           region shall be from the character before the starting cursor up to
           and including the character on the _c_o_u_n_tth column of the line.

        4. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       character that is displayed in the _c_o_u_n_t column of the line is
       displayed.

   RReevveerrssee FFiinndd CChhaarraacctteerr
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] ,

       If the last FF, ff, TT, or tt command was FF, ff, TT, or tt, this command shall
       be equivalent to an ff, FF, tt, or TT command, respectively, with the
       specified _c_o_u_n_t and the same search character.

       If there was no previous FF, ff, TT, or tt command, it shall be an error.

   RReeppeeaatt
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] .

       Repeat the last !!, <<, >>, AA, CC, DD, II, JJ, OO, PP, RR, SS, XX, YY, aa, cc, dd, ii,
       oo, pp, rr, ss, xx, yy, or ~~ command. It shall be an error if none of these
       commands have been executed. Commands (other than commands that enter
       text input mode) executed as a result of map expansions, shall not
       change the value of the last repeatable command.

       Repeated commands with associated motion commands shall repeat the
       motion command as well; however, any specified _c_o_u_n_t shall replace the
       _c_o_u_n_t(s) that were originally specified to the repeated command or its
       associated motion command.

       If the motion component of the repeated command is ff, FF, tt, or TT, the
       repeated command shall not set the remembered search character for the
       ;; and ,, commands.

       If the repeated command is pp or PP, and the buffer associated with that
       command was a numeric buffer named with a number less than 9, the
       buffer associated with the repeated command shall be set to be the
       buffer named by the name of the previous buffer logically incremented
       by 1.

       If the repeated character is a text input command, the input text
       associated with that command is repeated literally:

        *  Input characters are neither macro or abbreviation-expanded.

        *  Input characters are not interpreted in any special way with the
           exception that <newline>, <carriage-return>, and <control>-T behave
           as described in _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i.

       _C_u_r_r_e_n_t _l_i_n_e: Set as described for the repeated command.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set as described for the repeated command.

   FFiinndd RReegguullaarr EExxpprreessssiioonn
       _S_y_n_o_p_s_i_s:

                     /

       If the input line contains no non-<newline> characters, it shall be
       equivalent to a line containing only the last regular expression
       encountered. The enhanced regular expressions supported by _v_i are
       described in _R_e_g_u_l_a_r _E_x_p_r_e_s_s_i_o_n_s _i_n _e_x.

       Otherwise, the line shall be interpreted as one or more regular
       expressions, optionally followed by an address offset or a _v_i zz
       command.

       If the regular expression is not the last regular expression on the
       line, or if a line offset or zz command is specified, the regular
       expression shall be terminated by an unescaped ''//'' character, which
       shall not be used as part of the regular expression.  If the regular
       expression is not the first regular expression on the line, it shall be
       preceded by zero or more <blank> characters, a <semicolon>, zero or
       more <blank> characters, and a leading ''//'' character, which shall not
       be interpreted as part of the regular expression. It shall be an error
       to precede any regular expression with any characters other than these.

       Each search shall begin from the character after the first character of
       the last match (or, if it is the first search, after the cursor). If
       the wwrraappssccaann edit option is set, the search shall continue to the
       character before the starting cursor character; otherwise, to the end
       of the edit buffer. It shall be an error if any search fails to find a
       match, and an informational message to this effect shall be displayed.

       An optional address offset (see _A_d_d_r_e_s_s_i_n_g _i_n _e_x) can be specified
       after the last regular expression by including a trailing ''//'' character
       after the regular expression and specifying the address offset. This
       offset will be from the line containing the match for the last regular
       expression specified. It shall be an error if the line offset would
       indicate a line address less than 1 or greater than the last line in
       the edit buffer. An address offset of zero shall be supported. It shall
       be an error to follow the address offset with any other characters than
       <blank> characters.

       If not used as a motion command, an optional zz command (see _R_e_d_r_a_w
       _W_i_n_d_o_w) can be specified after the last regular expression by including
       a trailing ''//'' character after the regular expression, zero or more
       <blank> characters, a ''zz'', zero or more <blank> characters, an optional
       new wwiinnddooww edit option value, zero or more <blank> characters, and a
       location character. The effect shall be as if the zz command was
       executed after the // command. It shall be an error to follow the zz
       command with any other characters than <blank> characters.

       The remembered search direction shall be set to forward.

       If used as a motion command:

        1. It shall be an error if the last match references the same
           character in the edit buffer as the starting cursor.

        2. If any address offset is specified, the last match shall be
           adjusted by the specified offset as described previously.

        3. If the starting cursor is after the last match, then the locations
           of the starting cursor and the last match in the edit buffer shall
           be logically swapped.

        4. If any address offset is specified, the text region shall consist
           of all lines containing characters from the starting cursor to the
           last match line, inclusive, and any text copied to a buffer shall
           be in line mode.

        5. Otherwise, if the starting line is empty or the starting cursor is
           at or before the first non-<blank> non-<newline> of the starting
           line, and the last match line is empty or the last match starts at
           the first character of the last match line, the text region shall
           consist of all lines containing characters from the starting cursor
           to the line before the last match line, inclusive, and any text
           copied to a buffer shall be in line mode.

        6. Otherwise, if the last match line is empty or the last match begins
           at a character at or before the first non-<blank> non-<newline> of
           the last match line, the region of text shall be from the current
           cursor to the last non-<newline> of the line before the last match
           line, inclusive, and any text copied to a buffer shall be in
           character mode.

        7. Otherwise, the region of text shall be from the current cursor
           (inclusive), to the first character of the last match (exclusive),
           and any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: If a match is found, set to the last matched line plus
       the address offset, if any; otherwise, unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column on which any portion of the
       first character in the last matched string is displayed, if a match is
       found; otherwise, unchanged.

   MMoovvee ttoo FFiirrsstt CChhaarraacctteerr iinn LLiinnee
       _S_y_n_o_p_s_i_s:

                     0  (zero)

       Move to the first character on the current line. The character ''00''
       shall not be interpreted as a command if it is immediately preceded by
       a digit.

       If used as a motion command:

        1. If the cursor character is the first character in the line, it
           shall be an error.

        2. The text region shall be from the character before the cursor
           character up to and including the first character in the line.

        3. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: The last column in which any portion of the first
       character in the line is displayed, or if the line is empty, unchanged.

   EExxeeccuuttee aann eexx CCoommmmaanndd
       _S_y_n_o_p_s_i_s:

                     :

       Execute one or more _e_x commands.

       If any portion of the screen other than the last line of the screen was
       overwritten by any _e_x command (except sshheellll), _v_i shall display a
       message indicating that it is waiting for an input from the user, and
       shall then read a character. This action may also be taken for other,
       unspecified reasons.

       If the next character entered is a ''::'', another _e_x command shall be
       accepted and executed. Any other character shall cause the screen to be
       refreshed and _v_i shall return to command mode.

       _C_u_r_r_e_n_t _l_i_n_e: As specified for the _e_x command.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: As specified for the _e_x command.

   RReeppeeaatt FFiinndd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] ;

       This command shall be equivalent to the last FF, ff, TT, or tt command,
       with the specified _c_o_u_n_t, and with the same search character used for
       the last FF, ff, TT, or tt command. If there was no previous FF, ff, TT, or tt
       command, it shall be an error.

   SShhiifftt LLeefftt
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] < _m_o_t_i_o_n

       If the motion command is the << command repeated:

        1. If there are less than _c_o_u_n_t -1 lines after the current line in the
           edit buffer, it shall be an error.

        2. The text region shall be from the current line, up to and including
           the next _c_o_u_n_t -1 lines.

       Shift any line in the text region specified by the _c_o_u_n_t and motion
       command one shiftwidth (see the _e_x sshhiiffttwwiiddtthh option) toward the start
       of the line, as described by the _e_x << command. The unshifted lines
       shall be copied to the unnamed buffer in line mode.

       _C_u_r_r_e_n_t _l_i_n_e: If the motion was from the current cursor position toward
       the end of the edit buffer, unchanged. Otherwise, set to the first line
       in the edit buffer that is part of the text region specified by the
       motion command.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   SShhiifftt RRiigghhtt
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] > _m_o_t_i_o_n

       If the motion command is the >> command repeated:

        1. If there are less than _c_o_u_n_t -1 lines after the current line in the
           edit buffer, it shall be an error.

        2. The text region shall be from the current line, up to and including
           the next _c_o_u_n_t -1 lines.

       Shift any line with characters in the text region specified by the
       _c_o_u_n_t and motion command one shiftwidth (see the _e_x sshhiiffttwwiiddtthh option)
       away from the start of the line, as described by the _e_x >> command. The
       unshifted lines shall be copied into the unnamed buffer in line mode.

       _C_u_r_r_e_n_t _l_i_n_e: If the motion was from the current cursor position toward
       the end of the edit buffer, unchanged. Otherwise, set to the first line
       in the edit buffer that is part of the text region specified by the
       motion command.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   SSccaann BBaacckkwwaarrddss ffoorr RReegguullaarr EExxpprreessssiioonn
       _S_y_n_o_p_s_i_s:

                     ?

       Scan backwards; the ??  command shall be equivalent to the // command
       (see _F_i_n_d _R_e_g_u_l_a_r _E_x_p_r_e_s_s_i_o_n) with the following exceptions:

        1. The input prompt shall be a ''??''.

        2. Each search shall begin from the character before the first
           character of the last match (or, if it is the first search, the
           character before the cursor character).

        3. The search direction shall be from the cursor toward the beginning
           of the edit buffer, and the wwrraappssccaann edit option shall affect
           whether the search wraps to the end of the edit buffer and
           continues.

        4. The remembered search direction shall be set to backward.

   EExxeeccuuttee
       _S_y_n_o_p_s_i_s:

                     @_b_u_f_f_e_r

       If the _b_u_f_f_e_r is specified as @@, the last buffer executed shall be
       used. If no previous buffer has been executed, it shall be an error.

       Behave as if the contents of the named buffer were entered as standard
       input. After each line of a line-mode buffer, and all but the last line
       of a character mode buffer, behave as if a <newline> were entered as
       standard input.

       If an error occurs during this process, an error message shall be
       written, and no more characters resulting from the execution of this
       command shall be processed.

       If a _c_o_u_n_t is specified, behave as if that count were entered as user
       input before the characters from the @@ buffer were entered.

       _C_u_r_r_e_n_t _l_i_n_e: As specified for the individual commands.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: As specified for the individual commands.

   RReevveerrssee CCaassee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] ~

       Reverse the case of the current character and the next _c_o_u_n_t -1
       characters, such that lowercase characters that have uppercase
       counterparts shall be changed to uppercase characters, and uppercase
       characters that have lowercase counterparts shall be changed to
       lowercase characters, as prescribed by the current locale. No other
       characters shall be affected by this command.

       If there are less than _c_o_u_n_t -1 characters after the cursor in the edit
       buffer, _c_o_u_n_t shall be adjusted to the number of characters after the
       cursor in the edit buffer minus 1.

       For the purposes of this command, the next character after the last
       non-<newline> on the line shall be the next character in the edit
       buffer.

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line including the (_c_o_u_n_t-1)th character after
       the cursor.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       (_c_o_u_n_t-1)th character after the cursor is displayed.

   AAppppeenndd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] a

       Enter text input mode after the current cursor position. No characters
       already in the edit buffer shall be affected by this command. A _c_o_u_n_t
       shall cause the input text to be appended _c_o_u_n_t -1 more times to the
       end of the input.

       _C_u_r_r_e_n_t _l_i_n_e_/_c_o_l_u_m_n: As specified for the text input commands (see
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i).

   AAppppeenndd aatt EEnndd--ooff--LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] A

       This command shall be equivalent to the _v_i command:


           $ [[ _c_o_u_n_t ]] a

       (see _A_p_p_e_n_d).

   MMoovvee BBaacckkwwaarrdd ttoo PPrreecceeddiinngg WWoorrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] b

       With the exception that words are used as the delimiter instead of
       bigwords, this command shall be equivalent to the BB command.

   MMoovvee BBaacckkwwaarrdd ttoo PPrreecceeddiinngg BBiiggwwoorrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] B

       If the edit buffer is empty or the cursor is on the first character of
       the edit buffer, it shall be an error. If less than _c_o_u_n_t bigwords
       begin between the cursor and the start of the edit buffer, _c_o_u_n_t shall
       be adjusted to the number of bigword beginnings between the cursor and
       the start of the edit buffer.

       If used as a motion command:

        1. The text region shall be from the first character of the _c_o_u_n_tth
           previous bigword beginning up to but not including the cursor
           character.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line containing the _c_u_r_r_e_n_t _c_o_l_u_m_n.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column upon which any part of the first
       character of the _c_o_u_n_tth previous bigword is displayed.

   CChhaannggee
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] c _m_o_t_i_o_n

       If the motion command is the cc command repeated:

        1. The buffer text shall be in line mode.

        2. If there are less than _c_o_u_n_t -1 lines after the current line in the
           edit buffer, it shall be an error.

        3. The text region shall be from the current line up to and including
           the next _c_o_u_n_t -1 lines.

       Otherwise, the buffer text mode and text region shall be as specified
       by the motion command.

       The replaced text shall be copied into _b_u_f_f_e_r, if specified, and into
       the unnamed buffer. If the text to be replaced contains characters from
       more than a single line, or the buffer text is in line mode, the
       replaced text shall be copied into the numeric buffers as well.

       If the buffer text is in line mode:

        1. Any lines that contain characters in the region shall be deleted,
           and the editor shall enter text input mode at the beginning of a
           new line which shall replace the first line deleted.

        2. If the aauuttooiinnddeenntt edit option is set, aauuttooiinnddeenntt characters equal
           to the aauuttooiinnddeenntt characters on the first line deleted shall be
           inserted as if entered by the user.

       Otherwise, if characters from more than one line are in the region of
       text:

        1. The text shall be deleted.

        2. Any text remaining in the last line in the text region shall be
           appended to the first line in the region, and the last line in the
           region shall be deleted.

        3. The editor shall enter text input mode after the last character not
           deleted from the first line in the text region, if any; otherwise,
           on the first column of the first line in the region.

       Otherwise:

        1. If the glyph for ''$$'' is smaller than the region, the end of the
           region shall be marked with a ''$$''.

        2. The editor shall enter text input mode, overwriting the region of
           text.

       _C_u_r_r_e_n_t _l_i_n_e_/_c_o_l_u_m_n: As specified for the text input commands (see
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i).

   CChhaannggee ttoo EEnndd--ooff--LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] C

       This command shall be equivalent to the _v_i command:


           [[_b_u_f_f_e_r]][[_c_o_u_n_t]] c$

       See the cc command.

   DDeelleettee
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] d _m_o_t_i_o_n

       If the motion command is the dd command repeated:

        1. The buffer text shall be in line mode.

        2. If there are less than _c_o_u_n_t -1 lines after the current line in the
           edit buffer, it shall be an error.

        3. The text region shall be from the current line up to and including
           the next _c_o_u_n_t -1 lines.

       Otherwise, the buffer text mode and text region shall be as specified
       by the motion command.

       If in open mode, and the current line is deleted, and the line remains
       on the display, an ''@@'' character shall be displayed as the first glyph
       of that line.

       Delete the region of text into _b_u_f_f_e_r, if specified, and into the
       unnamed buffer. If the text to be deleted contains characters from more
       than a single line, or the buffer text is in line mode, the deleted
       text shall be copied into the numeric buffers, as well.

       _C_u_r_r_e_n_t _l_i_n_e: Set to the first text region line that appears in the
       edit buffer, unless that line has been deleted, in which case it shall
       be set to the last line in the edit buffer, or line 1 if the edit
       buffer is empty.

       _C_u_r_r_e_n_t _c_o_l_u_m_n:

        1. If the line is empty, set to column position 1.

        2. Otherwise, if the buffer text is in line mode or the motion was
           from the cursor toward the end of the edit buffer:

            a. If a character from the current line is displayed in the
               current column, set to the last column that displays any
               portion of that character.

            b. Otherwise, set to the last column in which any portion of any
               character in the line is displayed.

        3. Otherwise, if a character is displayed in the column that began the
           text region, set to the last column that displays any portion of
           that character.

        4. Otherwise, set to the last column in which any portion of any
           character in the line is displayed.

   DDeelleettee ttoo EEnndd--ooff--LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]] D

       Delete the text from the current position to the end of the current
       line; equivalent to the _v_i command:


           [[_b_u_f_f_e_r]] d$

   MMoovvee ttoo EEnndd--ooff--WWoorrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] e

       With the exception that words are used instead of bigwords as the
       delimiter, this command shall be equivalent to the EE command.

   MMoovvee ttoo EEnndd--ooff--BBiiggwwoorrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] E

       If the edit buffer is empty it shall be an error. If less than _c_o_u_n_t
       bigwords end between the cursor and the end of the edit buffer, _c_o_u_n_t
       shall be adjusted to the number of bigword endings between the cursor
       and the end of the edit buffer.

       If used as a motion command:

        1. The text region shall be from the last character of the _c_o_u_n_tth
           next bigword up to and including the cursor character.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line containing the current column.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column upon which any part of the last
       character of the _c_o_u_n_tth next bigword is displayed.

   FFiinndd CChhaarraacctteerr iinn CCuurrrreenntt LLiinnee ((FFoorrwwaarrdd))
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] f _c_h_a_r_a_c_t_e_r

       It shall be an error if _c_o_u_n_t occurrences of the character do not occur
       after the cursor in the line.

       If used as a motion command:

        1. The text range shall be from the cursor character up to and
           including the _c_o_u_n_tth occurrence of the specified character after
           the cursor.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       _c_o_u_n_tth occurrence of the specified character after the cursor appears
       in the line.

   FFiinndd CChhaarraacctteerr iinn CCuurrrreenntt LLiinnee ((RReevveerrssee))
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] F _c_h_a_r_a_c_t_e_r

       It shall be an error if _c_o_u_n_t occurrences of the character do not occur
       before the cursor in the line.

       If used as a motion command:

        1. The text region shall be from the _c_o_u_n_tth occurrence of the
           specified character before the cursor, up to, but not including the
           cursor character.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       _c_o_u_n_tth occurrence of the specified character before the cursor appears
       in the line.

   MMoovvee ttoo LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] G

       If _c_o_u_n_t is not specified, it shall default to the last line of the
       edit buffer.  If _c_o_u_n_t is greater than the last line of the edit
       buffer, it shall be an error.

       If used as a motion command:

        1. The text region shall be from the cursor line up to and including
           the specified line.

        2. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Set to _c_o_u_n_t if _c_o_u_n_t is specified; otherwise, the last
       line.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   MMoovvee ttoo TToopp ooff SSccrreeeenn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] H

       If the beginning of the line _c_o_u_n_t greater than the first line of which
       any portion appears on the display does not exist, it shall be an
       error.

       If used as a motion command:

        1. If in open mode, the text region shall be the current line.

        2. Otherwise, the text region shall be from the starting line up to
           and including (the first line of the display + _c_o_u_n_t -1).

        3. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

       If in open mode, this command shall set the current column to
       non-<blank> and do nothing else.

       Otherwise, it shall set the current line and current column as follows.

       _C_u_r_r_e_n_t _l_i_n_e: Set to (the first line of the display + _c_o_u_n_t -1).

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   IInnsseerrtt BBeeffoorree CCuurrssoorr
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] i

       Enter text input mode before the current cursor position. No characters
       already in the edit buffer shall be affected by this command. A _c_o_u_n_t
       shall cause the input text to be appended _c_o_u_n_t -1 more times to the
       end of the input.

       _C_u_r_r_e_n_t _l_i_n_e_/_c_o_l_u_m_n: As specified for the text input commands (see
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i).

   IInnsseerrtt aatt BBeeggiinnnniinngg ooff LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] I

       This command shall be equivalent to the _v_i command ^[_c_o_u_n_t]ii.

   JJooiinn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] J

       If the current line is the last line in the edit buffer, it shall be an
       error.

       This command shall be equivalent to the _e_x jjooiinn command with no
       addresses, and an _e_x command _c_o_u_n_t value of 1 if _c_o_u_n_t was not
       specified or if a _c_o_u_n_t of 1 was specified, and an _e_x command _c_o_u_n_t
       value of _c_o_u_n_t -1 for any other value of _c_o_u_n_t, except that the current
       line and column shall be set as follows.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: The last column in which any portion of the character
       following the last character in the initial line is displayed, or the
       last non-<newline> in the line if no characters were appended.

   MMoovvee ttoo BBoottttoomm ooff SSccrreeeenn
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] L

       If the beginning of the line _c_o_u_n_t less than the last line of which any
       portion appears on the display does not exist, it shall be an error.

       If used as a motion command:

        1. If in open mode, the text region shall be the current line.

        2. Otherwise, the text region shall include all lines from the
           starting cursor line to (the last line of the display -(_c_o_u_n_t -1)).

        3. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

        1. If in open mode, this command shall set the current column to
           non-<blank> and do nothing else.

        2. Otherwise, it shall set the current line and current column as
           follows.

       _C_u_r_r_e_n_t _l_i_n_e: Set to (the last line of the display -(_c_o_u_n_t -1)).

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   MMaarrkk PPoossiittiioonn
       _S_y_n_o_p_s_i_s:

                     m _l_e_t_t_e_r

       This command shall be equivalent to the _e_x mmaarrkk command with the
       specified character as an argument.

   MMoovvee ttoo MMiiddddllee ooff SSccrreeeenn
       _S_y_n_o_p_s_i_s:

                     M

       The middle line of the display shall be calculated as follows:


           (the top line of the display) + (((number of lines displayed) +1) /2) -1

       If used as a motion command:

        1. If in open mode, the text region shall be the current line.

        2. Otherwise, the text region shall include all lines from the
           starting cursor line up to and including the middle line of the
           display.

        3. Any text copied to a buffer shall be in line mode.

       If not used as a motion command:

       If in open mode, this command shall set the current column to
       non-<blank> and do nothing else.

       Otherwise, it shall set the current line and current column as follows.

       _C_u_r_r_e_n_t _l_i_n_e: Set to the middle line of the display.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   RReeppeeaatt RReegguullaarr EExxpprreessssiioonn FFiinndd ((FFoorrwwaarrdd))
       _S_y_n_o_p_s_i_s:

                     n

       If the remembered search direction was forward, the nn command shall be
       equivalent to the _v_i // command with no characters entered by the user.
       Otherwise, it shall be equivalent to the _v_i ??  command with no
       characters entered by the user.

       If the nn command is used as a motion command for the !!  command, the
       editor shall not enter text input mode on the last line on the screen,
       and shall behave as if the user entered a single ''!!''  character as the
       text input.

   RReeppeeaatt RReegguullaarr EExxpprreessssiioonn FFiinndd ((RReevveerrssee))
       _S_y_n_o_p_s_i_s:

                     N

       Scan for the next match of the last pattern given to // or ??, but in the
       reverse direction; this is the reverse of nn.

       If the remembered search direction was forward, the NN command shall be
       equivalent to the _v_i ??  command with no characters entered by the user.
       Otherwise, it shall be equivalent to the _v_i // command with no
       characters entered by the user. If the NN command is used as a motion
       command for the !!  command, the editor shall not enter text input mode
       on the last line on the screen, and shall behave as if the user entered
       a single !!  character as the text input.

   IInnsseerrtt EEmmppttyy LLiinnee BBeellooww
       _S_y_n_o_p_s_i_s:

                     o

       Enter text input mode in a new line appended after the current line. A
       _c_o_u_n_t shall cause the input text to be appended _c_o_u_n_t -1 more times to
       the end of the already added text, each time starting on a new,
       appended line.

       _C_u_r_r_e_n_t _l_i_n_e_/_c_o_l_u_m_n: As specified for the text input commands (see
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i).

   IInnsseerrtt EEmmppttyy LLiinnee AAbboovvee
       _S_y_n_o_p_s_i_s:

                     O

       Enter text input mode in a new line inserted before the current line. A
       _c_o_u_n_t shall cause the input text to be appended _c_o_u_n_t -1 more times to
       the end of the already added text, each time starting on a new,
       appended line.

       _C_u_r_r_e_n_t _l_i_n_e_/_c_o_l_u_m_n: As specified for the text input commands (see
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i).

   PPuutt ffrroomm BBuuffffeerr FFoolllloowwiinngg
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]] p

       If no _b_u_f_f_e_r is specified, the unnamed buffer shall be used.

       If the buffer text is in line mode, the text shall be appended below
       the current line, and each line of the buffer shall become a new line
       in the edit buffer. A _c_o_u_n_t shall cause the buffer text to be appended
       _c_o_u_n_t -1 more times to the end of the already added text, each time
       starting on a new, appended line.

       If the buffer text is in character mode, the text shall be appended
       into the current line after the cursor, and each line of the buffer
       other than the first and last shall become a new line in the edit
       buffer. A _c_o_u_n_t shall cause the buffer text to be appended _c_o_u_n_t -1
       more times to the end of the already added text, each time starting
       after the last added character.

       _C_u_r_r_e_n_t _l_i_n_e: If the buffer text is in line mode, set the line to line
       +1; otherwise, unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: If the buffer text is in line mode:

        1. If there is a non-<blank> in the first line of the buffer, set to
           the last column on which any portion of the first non-<blank> in
           the line is displayed.

        2. If there is no non-<blank> in the first line of the buffer, set to
           the last column on which any portion of the last non-<newline> in
           the first line of the buffer is displayed.

       If the buffer text is in character mode:

        1. If the text in the buffer is from more than a single line, then set
           to the last column on which any portion of the first character from
           the buffer is displayed.

        2. Otherwise, if the buffer is the unnamed buffer, set to the last
           column on which any portion of the last character from the buffer
           is displayed.

        3. Otherwise, set to the first column on which any portion of the
           first character from the buffer is displayed.

   PPuutt ffrroomm BBuuffffeerr BBeeffoorree
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]] P

       If no _b_u_f_f_e_r is specified, the unnamed buffer shall be used.

       If the buffer text is in line mode, the text shall be inserted above
       the current line, and each line of the buffer shall become a new line
       in the edit buffer. A _c_o_u_n_t shall cause the buffer text to be appended
       _c_o_u_n_t -1 more times to the end of the already added text, each time
       starting on a new, appended line.

       If the buffer text is in character mode, the text shall be inserted
       into the current line before the cursor, and each line of the buffer
       other than the first and last shall become a new line in the edit
       buffer. A _c_o_u_n_t shall cause the buffer text to be appended _c_o_u_n_t -1
       more times to the end of the already added text, each time starting
       after the last added character.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: If the buffer text is in line mode:

        1. If there is a non-<blank> in the first line of the buffer, set to
           the last column on which any portion of that character is
           displayed.

        2. If there is no non-<blank> in the first line of the buffer, set to
           the last column on which any portion of the last non-<newline> in
           the first line of the buffer is displayed.

       If the buffer text is in character mode:

        1. If the text in the buffer is from more than a single line, then set
           to the last column on which any portion of the first character from
           the buffer is displayed.

        2. Otherwise, if the buffer is the unnamed buffer, set to the last
           column on which any portion of the last character from the buffer
           is displayed.

        3. Otherwise, set to the first column on which any portion of the
           first character from the buffer is displayed.

   EEnntteerr eexx MMooddee
       _S_y_n_o_p_s_i_s:

                     Q

       Leave visual or open mode and enter _e_x command mode.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   RReeppllaaccee CChhaarraacctteerr
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] r _c_h_a_r_a_c_t_e_r

       Replace the _c_o_u_n_t characters at and after the cursor with the specified
       character. If there are less than _c_o_u_n_t non-<newline> characters at and
       after the cursor on the line, it shall be an error.

       If character is <control>-V, any next character other than the
       <newline> shall be stripped of any special meaning and used as a
       literal character.

       If character is <ESC>, no replacement shall be made and the current
       line and current column shall be unchanged.

       If character is <carriage-return> or <newline>, _c_o_u_n_t new lines shall
       be appended to the current line. All but the last of these lines shall
       be empty.  _c_o_u_n_t characters at and after the cursor shall be discarded,
       and any remaining characters after the cursor in the current line shall
       be moved to the last of the new lines. If the aauuttooiinnddeenntt edit option is
       set, they shall be preceded by the same number of aauuttooiinnddeenntt characters
       found on the line from which the command was executed.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged unless the replacement character is a
       <carriage-return> or <newline>, in which case it shall be set to line +
       _c_o_u_n_t.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column position on which a portion of
       the last replaced character is displayed, or if the replacement
       character caused new lines to be created, set to non-<blank>.

   RReeppllaaccee CChhaarraacctteerrss
       _S_y_n_o_p_s_i_s:

                     R

       Enter text input mode at the current cursor position possibly replacing
       text on the current line. A _c_o_u_n_t shall cause the input text to be
       appended _c_o_u_n_t -1 more times to the end of the input.

       _C_u_r_r_e_n_t _l_i_n_e_/_c_o_l_u_m_n: As specified for the text input commands (see
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i).

   SSuubbssttiittuuttee CChhaarraacctteerr
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] s

       This command shall be equivalent to the _v_i command:


           [[_b_u_f_f_e_r]][[_c_o_u_n_t]] c<space>

   SSuubbssttiittuuttee LLiinneess
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] S

       This command shall be equivalent to the _v_i command:


           [[_b_u_f_f_e_r]][[_c_o_u_n_t]] c_

   MMoovvee CCuurrssoorr ttoo BBeeffoorree CChhaarraacctteerr ((FFoorrwwaarrdd))
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] t _c_h_a_r_a_c_t_e_r

       It shall be an error if _c_o_u_n_t occurrences of the character do not occur
       after the cursor in the line.

       If used as a motion command:

        1. The text region shall be from the cursor up to but not including
           the _c_o_u_n_tth occurrence of the specified character after the cursor.

        2. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       character before the _c_o_u_n_tth occurrence of the specified character
       after the cursor appears in the line.

   MMoovvee CCuurrssoorr ttoo AAfftteerr CChhaarraacctteerr ((RReevveerrssee))
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] T _c_h_a_r_a_c_t_e_r

       It shall be an error if _c_o_u_n_t occurrences of the character do not occur
       before the cursor in the line.

       If used as a motion command:

        1. If the character before the cursor is the specified character, it
           shall be an error.

        2. The text region shall be from the character before the cursor up to
           but not including the _c_o_u_n_tth occurrence of the specified character
           before the cursor.

        3. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any portion of the
       character after the _c_o_u_n_tth occurrence of the specified character
       before the cursor appears in the line.

   UUnnddoo
       _S_y_n_o_p_s_i_s:

                     u

       This command shall be equivalent to the _e_x uunnddoo command except that the
       current line and current column shall be set as follows:

       _C_u_r_r_e_n_t _l_i_n_e: Set to the first line added or changed if any; otherwise,
       move to the line preceding any deleted text if one exists; otherwise,
       move to line 1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: If undoing an _e_x command, set to the first non-<blank>.

       Otherwise, if undoing a text input command:

        1. If the command was a CC, cc, OO, oo, RR, SS, or ss command, the current
           column shall be set to the value it held when the text input
           command was entered.

        2. Otherwise, set to the last column in which any portion of the first
           character after the deleted text is displayed, or, if no
           non-<newline> characters follow the text deleted from this line,
           set to the last column in which any portion of the last
           non-<newline> in the line is displayed, or 1 if the line is empty.

       Otherwise, if a single line was modified (that is, not added or
       deleted) by the uu command:

        1. If text was added or changed, set to the last column in which any
           portion of the first character added or changed is displayed.

        2. If text was deleted, set to the last column in which any portion of
           the first character after the deleted text is displayed, or, if no
           non-<newline> characters follow the deleted text, set to the last
           column in which any portion of the last non-<newline> in the line
           is displayed, or 1 if the line is empty.

       Otherwise, set to non-<blank>.

   UUnnddoo CCuurrrreenntt LLiinnee
       _S_y_n_o_p_s_i_s:

                     U

       Restore the current line to its state immediately before the most
       recent time that it became the current line.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the first column in the line in which any
       portion of the first character in the line is displayed.

   MMoovvee ttoo BBeeggiinnnniinngg ooff WWoorrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] w

       With the exception that words are used as the delimiter instead of
       bigwords, this command shall be equivalent to the WW command.

   MMoovvee ttoo BBeeggiinnnniinngg ooff BBiiggwwoorrdd
       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] W

       If the edit buffer is empty, it shall be an error. If there are less
       than _c_o_u_n_t bigwords between the cursor and the end of the edit buffer,
       _c_o_u_n_t shall be adjusted to move the cursor to the last bigword in the
       edit buffer.

       If used as a motion command:

        1. If the associated command is cc, _c_o_u_n_t is 1, and the cursor is on a
           <blank>, the region of text shall be the current character and no
           further action shall be taken.

        2. If there are less than _c_o_u_n_t bigwords between the cursor and the
           end of the edit buffer, then the command shall succeed, and the
           region of text shall include the last character of the edit buffer.

        3. If there are <blank> characters or an end-of-line that precede the
           _c_o_u_n_tth bigword, and the associated command is cc, the region of
           text shall be up to and including the last character before the
           preceding <blank> characters or end-of-line.

        4. If there are <blank> characters or an end-of-line that precede the
           bigword, and the associated command is dd or yy, the region of text
           shall be up to and including the last <blank> before the start of
           the bigword or end-of-line.

        5. Any text copied to a buffer shall be in character mode.

       If not used as a motion command:

        1. If the cursor is on the last character of the edit buffer, it shall
           be an error.

       _C_u_r_r_e_n_t _l_i_n_e: Set to the line containing the current column.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the last column in which any part of the first
       character of the _c_o_u_n_tth next bigword is displayed.

   DDeelleettee CChhaarraacctteerr aatt CCuurrssoorr
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] x

       Delete the _c_o_u_n_t characters at and after the current character into
       _b_u_f_f_e_r, if specified, and into the unnamed buffer.

       If the line is empty, it shall be an error. If there are less than
       _c_o_u_n_t non-<newline> characters at and after the cursor on the current
       line, _c_o_u_n_t shall be adjusted to the number of non-<newline> characters
       at and after the cursor.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: If the line is empty, set to column position 1.
       Otherwise, if there were _c_o_u_n_t or less non-<newline> characters at and
       after the cursor on the current line, set to the last column that
       displays any part of the last non-<newline> of the line. Otherwise,
       unchanged.

   DDeelleettee CChhaarraacctteerr BBeeffoorree CCuurrssoorr
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] X

       Delete the _c_o_u_n_t characters before the current character into _b_u_f_f_e_r,
       if specified, and into the unnamed buffer.

       If there are no characters before the current character on the current
       line, it shall be an error. If there are less than _c_o_u_n_t previous
       characters on the current line, _c_o_u_n_t shall be adjusted to the number
       of previous characters on the line.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to (current column - the width of the deleted
       characters).

   YYaannkk
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] y _m_o_t_i_o_n

       Copy (yank) the region of text into _b_u_f_f_e_r, if specified, and into the
       unnamed buffer.

       If the motion command is the yy command repeated:

        1. The buffer shall be in line mode.

        2. If there are less than _c_o_u_n_t -1 lines after the current line in the
           edit buffer, it shall be an error.

        3. The text region shall be from the current line up to and including
           the next _c_o_u_n_t -1 lines.

       Otherwise, the buffer text mode and text region shall be as specified
       by the motion command.

       _C_u_r_r_e_n_t _l_i_n_e: If the motion was from the current cursor position toward
       the end of the edit buffer, unchanged. Otherwise, set to the first line
       in the edit buffer that is part of the text region specified by the
       motion command.

       _C_u_r_r_e_n_t _c_o_l_u_m_n:

        1. If the motion was from the current cursor position toward the end
           of the edit buffer, unchanged.

        2. Otherwise, if the current line is empty, set to column position 1.

        3. Otherwise, set to the last column that displays any part of the
           first character in the file that is part of the text region
           specified by the motion command.

   YYaannkk CCuurrrreenntt LLiinnee
       _S_y_n_o_p_s_i_s:

                     [[_b_u_f_f_e_r]][[_c_o_u_n_t]] Y

       This command shall be equivalent to the _v_i command:


           [[_b_u_f_f_e_r]][[_c_o_u_n_t]] y_

   RReeddrraaww WWiinnddooww
       If in open mode, the zz command shall have the Synopsis:

       _S_y_n_o_p_s_i_s:

                     [[_c_o_u_n_t]] z

       If _c_o_u_n_t is not specified, it shall default to the wwiinnddooww edit option
       -1. The zz command shall be equivalent to the _e_x zz command, with a type
       character of == and a _c_o_u_n_t of _c_o_u_n_t -2, except that the current line
       and current column shall be set as follows, and the wwiinnddooww edit option
       shall not be affected. If the calculation for the _c_o_u_n_t argument would
       result in a negative number, the _c_o_u_n_t argument to the _e_x zz command
       shall be zero. A blank line shall be written after the last line is
       written.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

       If not in open mode, the zz command shall have the following Synopsis:

       _S_y_n_o_p_s_i_s:

                     [[_l_i_n_e]] z [[_c_o_u_n_t]] _c_h_a_r_a_c_t_e_r

       If _l_i_n_e is not specified, it shall default to the current line. If _l_i_n_e
       is specified, but is greater than the number of lines in the edit
       buffer, it shall default to the number of lines in the edit buffer.

       If _c_o_u_n_t is specified, the value of the wwiinnddooww edit option shall be set
       to _c_o_u_n_t (as described in the _e_x wwiinnddooww command), and the screen shall
       be redrawn.

       _l_i_n_e shall be placed as specified by the following characters:

       <newline>, <carriage-return>
             Place the beginning of the line on the first line of the display.

       .     Place the beginning of the line in the center of the display. The
             middle line of the display shall be calculated as described for
             the MM command.

       -     Place an unspecified portion of the line on the last line of the
             display.

       +     If _l_i_n_e was specified, equivalent to the <newline> case. If _l_i_n_e
             was not specified, display a screen where the first line of the
             display shall be (current last line) +1. If there are no lines
             after the last line in the display, it shall be an error.

       ^     If _l_i_n_e was specified, display a screen where the last line of
             the display shall contain an unspecified portion of the first
             line of a display that had an unspecified portion of the
             specified line on the last line of the display. If this
             calculation results in a line before the beginning of the edit
             buffer, display the first screen of the edit buffer.

             Otherwise, display a screen where the last line of the display
             shall contain an unspecified portion of (current first line -1).
             If this calculation results in a line before the beginning of the
             edit buffer, it shall be an error.

       _C_u_r_r_e_n_t _l_i_n_e: If _l_i_n_e and the ''^^'' character were specified:

        1. If the first screen was displayed as a result of the command
           attempting to display lines before the beginning of the edit
           buffer: if the first screen was already displayed, unchanged;
           otherwise, set to (current first line -1).

        2. Otherwise, set to the last line of the display.

       If _l_i_n_e and the ''++'' character were specified, set to the first line of
       the display.

       Otherwise, if _l_i_n_e was specified, set to _l_i_n_e.

       Otherwise, unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to non-<blank>.

   EExxiitt
       _S_y_n_o_p_s_i_s:

                     ZZ

       This command shall be equivalent to the _e_x xxiitt command with no
       addresses, trailing !!, or filename (see the _e_x xxiitt command).

   IInnppuutt MMooddee CCoommmmaannddss iinn vvii
       In text input mode, the current line shall consist of zero or more of
       the following categories, plus the terminating <newline>:

        1. Characters preceding the text input entry point

           Characters in this category shall not be modified during text input
           mode.

        2. aauuttooiinnddeenntt characters

           aauuttooiinnddeenntt characters shall be automatically inserted into each
           line that is created in text input mode, either as a result of
           entering a <newline> or <carriage-return> while in text input mode,
           or as an effect of the command itself; for example, OO or oo (see the
           _e_x aauuttooiinnddeenntt command), as if entered by the user.

           It shall be possible to erase aauuttooiinnddeenntt characters with the
           <control>-D command; it is unspecified whether they can be erased
           by <control>-H, <control>-U, and <control>-W characters. Erasing
           any aauuttooiinnddeenntt character turns the glyph into erase-columns and
           deletes the character from the edit buffer, but does not change its
           representation on the screen.

        3. Text input characters

           Text input characters are the characters entered by the user.
           Erasing any text input character turns the glyph into erase-columns
           and deletes the character from the edit buffer, but does not change
           its representation on the screen.

           Each text input character entered by the user (that does not have a
           special meaning) shall be treated as follows:

            a. The text input character shall be appended to the last
               character in the edit buffer from the first, second, or third
               categories.

            b. If there are no erase-columns on the screen, the text input
               command was the RR command, and characters in the fifth category
               from the original line follow the cursor, the next such
               character shall be deleted from the edit buffer. If the
               sslloowwooppeenn edit option is not set, the corresponding glyph on the
               screen shall become erase-columns.

            c. If there are erase-columns on the screen, as many columns as
               they occupy, or as are necessary, shall be overwritten to
               display the text input character. (If only part of a multi-
               column glyph is overwritten, the remainder shall be left on the
               screen, and continue to be treated as erase-columns; it is
               unspecified whether the remainder of the glyph is modified in
               any way.)

            d. If additional display line columns are needed to display the
               text input character:

                i.  If the sslloowwooppeenn edit option is set, the text input
                    characters shall be displayed on subsequent display line
                    columns, overwriting any characters displayed in those
                    columns.

               ii.  Otherwise, any characters currently displayed on or after
                    the column on the display line where the text input
                    character is to be displayed shall be pushed ahead the
                    number of display line columns necessary to display the
                    rest of the text input character.

        4. Erase-columns

           Erase-columns are not logically part of the edit buffer, appearing
           only on the screen, and may be overwritten on the screen by
           subsequent text input characters. When text input mode ends, all
           erase-columns shall no longer appear on the screen.

           Erase-columns are initially the region of text specified by the cc
           command (see _C_h_a_n_g_e); however, erasing aauuttooiinnddeenntt or text input
           characters causes the glyphs of the erased characters to be treated
           as erase-columns.

        5. Characters following the text region for the cc command, or the text
           input entry point for all other commands

           Characters in this category shall not be modified during text input
           mode, except as specified in category 3.b. for the RR text input
           command, or as <blank> characters deleted when a <newline> or
           <carriage-return> is entered.

       It is unspecified whether it is an error to attempt to erase past the
       beginning of a line that was created by the entry of a <newline> or
       <carriage-return> during text input mode. If it is not an error, the
       editor shall behave as if the erasing character was entered immediately
       after the last text input character entered on the previous line, and
       all of the non-<newline> characters on the current line shall be
       treated as erase-columns.

       When text input mode is entered, or after a text input mode character
       is entered (except as specified for the special characters below), the
       cursor shall be positioned as follows:

        1. On the first column that displays any part of the first erase-
           column, if one exists

        2. Otherwise, if the sslloowwooppeenn edit option is set, on the first display
           line column after the last character in the first, second, or third
           categories, if one exists

        3. Otherwise, the first column that displays any part of the first
           character in the fifth category, if one exists

        4. Otherwise, the display line column after the last character in the
           first, second, or third categories, if one exists

        5. Otherwise, on column position 1

       The characters that are updated on the screen during text input mode
       are unspecified, other than that the last text input character shall
       always be updated, and, if the sslloowwooppeenn edit option is not set, the
       current cursor character shall always be updated.

       The following specifications are for command characters entered during
       text input mode.

   NNUULL
       _S_y_n_o_p_s_i_s:

                     NUL

       If the first character of the text input is a NUL, the most recently
       input text shall be input as if entered by the user, and then text
       input mode shall be exited. The text shall be input literally; that is,
       characters are neither macro or abbreviation expanded, nor are any
       characters interpreted in any special manner. It is unspecified whether
       implementations shall support more than 256 bytes of remembered input
       text.

   <<ccoonnttrrooll>>--DD
       _S_y_n_o_p_s_i_s:

                     <control>-D

       The <control>-D character shall have no special meaning when in text
       input mode for a line-oriented command (see _C_o_m_m_a_n_d _D_e_s_c_r_i_p_t_i_o_n_s _i_n
       _v_i).

       This command need not be supported on block-mode terminals.

       If the cursor does not follow an aauuttooiinnddeenntt character, or an aauuttooiinnddeenntt
       character and a ''00'' or ''^^'' character:

        1. If the cursor is in column position 1, the <control>-D character
           shall be discarded and no further action taken.

        2. Otherwise, the <control>-D character shall have no special meaning.

       If the last input character was a ''00'', the cursor shall be moved to
       column position 1.

       Otherwise, if the last input character was a ''^^'', the cursor shall be
       moved to column position 1. In addition, the aauuttooiinnddeenntt level for the
       next input line shall be derived from the same line from which the
       aauuttooiinnddeenntt level for the current input line was derived.

       Otherwise, the cursor shall be moved back to the column after the
       previous shiftwidth (see the _e_x sshhiiffttwwiiddtthh command) boundary.

       All of the glyphs on columns between the starting cursor position and
       (inclusively) the ending cursor position shall become erase-columns as
       described in _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to 1 if the <control>-D was preceded by a ''^^'' or
       ''00''; otherwise, set to (column -1) -((column -2) % sshhiiffttwwiiddtthh).

   <<ccoonnttrrooll>>--HH
       _S_y_n_o_p_s_i_s:

                     <control>-H

       If in text input mode for a line-oriented command, and there are no
       characters to erase, text input mode shall be terminated, no further
       action shall be done for this command, and the current line and column
       shall be unchanged.

       If there are characters other than aauuttooiinnddeenntt characters that have been
       input on the current line before the cursor, the cursor shall move back
       one character.

       Otherwise, if there are aauuttooiinnddeenntt characters on the current line
       before the cursor, it is implementation-defined whether the <control>-H
       command is an error or if the cursor moves back one aauuttooiinnddeenntt
       character.

       Otherwise, if the cursor is in column position 1 and there are previous
       lines that have been input, it is implementation-defined whether the
       <control>-H command is an error or if it is equivalent to entering
       <control>-H after the last input character on the previous input line.

       Otherwise, it shall be an error.

       All of the glyphs on columns between the starting cursor position and
       (inclusively) the ending cursor position shall become erase-columns as
       described in _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i.

       The current erase character (see _s_t_t_y) shall cause an equivalent action
       to the <control>-H command, unless the previously inserted character
       was a <backslash>, in which case it shall be as if the literal current
       erase character had been inserted instead of the <backslash>.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged, unless previously input lines are erased, in
       which case it shall be set to line -1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the first column that displays any portion of
       the character backed up over.

   <<nneewwlliinnee>>
       _S_y_n_o_p_s_i_s:

                     <newline>
                     <carriage-return>
                     <control>-J
                     <control>-M

       If input was part of a line-oriented command, text input mode shall be
       terminated and the command shall continue execution with the input
       provided.

       Otherwise, terminate the current line. If there are no characters other
       than aauuttooiinnddeenntt characters on the line, all characters on the line
       shall be discarded.  Otherwise, it is unspecified whether the
       aauuttooiinnddeenntt characters in the line are modified by entering these
       characters.

       Continue text input mode on a new line appended after the current line.
       If the sslloowwooppeenn edit option is set, the lines on the screen below the
       current line shall not be pushed down, but the first of them shall be
       cleared and shall appear to be overwritten. Otherwise, the lines of the
       screen below the current line shall be pushed down.

       If the aauuttooiinnddeenntt edit option is set, an appropriate number of
       aauuttooiinnddeenntt characters shall be added as a prefix to the line as
       described by the _e_x aauuttooiinnddeenntt edit option.

       All columns after the cursor that are erase-columns (as described in
       _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i) shall be discarded.

       If the aauuttooiinnddeenntt edit option is set, all <blank> characters
       immediately following the cursor shall be discarded.

       All remaining characters after the cursor shall be transferred to the
       new line, positioned after any aauuttooiinnddeenntt characters.

       _C_u_r_r_e_n_t _l_i_n_e: Set to current line +1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the first column that displays any portion of
       the first character after the aauuttooiinnddeenntt characters on the new line, if
       any, or the first column position after the last aauuttooiinnddeenntt character,
       if any, or column position 1.

   <<ccoonnttrrooll>>--TT
       _S_y_n_o_p_s_i_s:

                     <control>-T

       The <control>-T character shall have no special meaning when in text
       input mode for a line-oriented command (see _C_o_m_m_a_n_d _D_e_s_c_r_i_p_t_i_o_n_s _i_n
       _v_i).

       This command need not be supported on block-mode terminals.

       Behave as if the user entered the minimum number of <blank> characters
       necessary to move the cursor forward to the column position after the
       next sshhiiffttwwiiddtthh (see the _e_x sshhiiffttwwiiddtthh command) boundary.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to _c_o_l_u_m_n + sshhiiffttwwiiddtthh - ((column -1) %
       sshhiiffttwwiiddtthh).

   <<ccoonnttrrooll>>--UU
       _S_y_n_o_p_s_i_s:

                     <control>-U

       If there are characters other than aauuttooiinnddeenntt characters that have been
       input on the current line before the cursor, the cursor shall move to
       the first character input after the aauuttooiinnddeenntt characters.

       Otherwise, if there are aauuttooiinnddeenntt characters on the current line
       before the cursor, it is implementation-defined whether the <control>-U
       command is an error or if the cursor moves to the first column position
       on the line.

       Otherwise, if the cursor is in column position 1 and there are previous
       lines that have been input, it is implementation-defined whether the
       <control>-U command is an error or if it is equivalent to entering
       <control>-U after the last input character on the previous input line.

       Otherwise, it shall be an error.

       All of the glyphs on columns between the starting cursor position and
       (inclusively) the ending cursor position shall become erase-columns as
       described in _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i.

       The current _k_i_l_l character (see _s_t_t_y) shall cause an equivalent action
       to the <control>-U command, unless the previously inserted character
       was a <backslash>, in which case it shall be as if the literal current
       _k_i_l_l character had been inserted instead of the <backslash>.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged, unless previously input lines are erased, in
       which case it shall be set to line -1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the first column that displays any portion of
       the last character backed up over.

   <<ccoonnttrrooll>>--VV
       _S_y_n_o_p_s_i_s:

                     <control>-V
                     <control>-Q

       Allow the entry of any subsequent character, other than <control>-J or
       the <newline>, as a literal character, removing any special meaning
       that it may have to the editor in text input mode. If a <control>-V or
       <control>-Q is entered before a <control>-J or <newline>, the
       <control>-V or <control>-Q character shall be discarded, and the
       <control>-J or <newline> shall behave as described in the <newline>
       command character during input mode.

       For purposes of the display only, the editor shall behave as if a ''^^''
       character was entered, and the cursor shall be positioned as if
       overwriting the ''^^'' character. When a subsequent character is entered,
       the editor shall behave as if that character was entered instead of the
       original <control>-V or <control>-Q character.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Unchanged.

   <<ccoonnttrrooll>>--WW
       _S_y_n_o_p_s_i_s:

                     <control>-W

       If there are characters other than aauuttooiinnddeenntt characters that have been
       input on the current line before the cursor, the cursor shall move back
       over the last word preceding the cursor (including any <blank>
       characters between the end of the last word and the current cursor);
       the cursor shall not move to before the first character after the end
       of any aauuttooiinnddeenntt characters.

       Otherwise, if there are aauuttooiinnddeenntt characters on the current line
       before the cursor, it is implementation-defined whether the <control>-W
       command is an error or if the cursor moves to the first column position
       on the line.

       Otherwise, if the cursor is in column position 1 and there are previous
       lines that have been input, it is implementation-defined whether the
       <control>-W command is an error or if it is equivalent to entering
       <control>-W after the last input character on the previous input line.

       Otherwise, it shall be an error.

       All of the glyphs on columns between the starting cursor position and
       (inclusively) the ending cursor position shall become erase-columns as
       described in _I_n_p_u_t _M_o_d_e _C_o_m_m_a_n_d_s _i_n _v_i.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged, unless previously input lines are erased, in
       which case it shall be set to line -1.

       _C_u_r_r_e_n_t _c_o_l_u_m_n: Set to the first column that displays any portion of
       the last character backed up over.

   <<EESSCC>>
       _S_y_n_o_p_s_i_s:

                     <ESC>

       If input was part of a line-oriented command:

        1. If _i_n_t_e_r_r_u_p_t was entered, text input mode shall be terminated and
           the editor shall return to command mode. The terminal shall be
           alerted.

        2. If <ESC> was entered, text input mode shall be terminated and the
           command shall continue execution with the input provided.

       Otherwise, terminate text input mode and return to command mode.

       Any aauuttooiinnddeenntt characters entered on newly created lines that have no
       other non-<newline> characters shall be deleted.

       Any leading aauuttooiinnddeenntt and <blank> characters on newly created lines
       shall be rewritten to be the minimum number of <blank> characters
       possible.

       The screen shall be redisplayed as necessary to match the contents of
       the edit buffer.

       _C_u_r_r_e_n_t _l_i_n_e: Unchanged.

       _C_u_r_r_e_n_t _c_o_l_u_m_n:

        1. If there are text input characters on the current line, the column
           shall be set to the last column where any portion of the last text
           input character is displayed.

        2. Otherwise, if a character is displayed in the current column,
           unchanged.

        3. Otherwise, set to column position 1.

EEXXIITT SSTTAATTUUSS
       The following exit values shall be returned:

        0    Successful completion.

       >0    An error occurred.

CCOONNSSEEQQUUEENNCCEESS OOFF EERRRROORRSS
       When any error is encountered and the standard input is not a terminal
       device file, _v_i shall not write the file or return to command or text
       input mode, and shall terminate with a non-zero exit status.

       Otherwise, when an unrecoverable error is encountered it shall be
       equivalent to a SIGHUP asynchronous event.

       Otherwise, when an error is encountered, the editor shall behave as
       specified in _C_o_m_m_a_n_d _D_e_s_c_r_i_p_t_i_o_n_s _i_n _v_i.

       _T_h_e _f_o_l_l_o_w_i_n_g _s_e_c_t_i_o_n_s _a_r_e _i_n_f_o_r_m_a_t_i_v_e_.

AAPPPPLLIICCAATTIIOONN UUSSAAGGEE
       None.

EEXXAAMMPPLLEESS
       None.

RRAATTIIOONNAALLEE
       See the RATIONALE for _e_x for more information on _v_i.  Major portions of
       the _v_i utility specification point to _e_x to avoid inadvertent
       divergence. While _e_x and _v_i have historically been implemented as a
       single utility, this is not required by POSIX.1-2008.

       It is recognized that portions of _v_i would be difficult, if not
       impossible, to implement satisfactorily on a block-mode terminal, or a
       terminal without any form of cursor addressing, thus it is not a
       mandatory requirement that such features should work on all terminals.
       It is the intention, however, that a _v_i implementation should provide
       the full set of capabilities on all terminals capable of supporting
       them.

       Historically, _v_i exited immediately if the standard input was not a
       terminal. POSIX.1-2008 permits, but does not require, this behavior. An
       end-of-file condition is not equivalent to an end-of-file character. A
       common end-of-file character, <control>-D, is historically a _v_i
       command.

       The text in the STDOUT section reflects the usage of the verb _d_i_s_p_l_a_y
       in this section; some implementations of _v_i use standard output to
       write to the terminal, but POSIX.1-2008 does not require that to be the
       case.

       Historically, implementations reverted to open mode if the terminal was
       incapable of supporting full visual mode. POSIX.1-2008 requires this
       behavior. Historically, the open mode of _v_i behaved roughly
       equivalently to the visual mode, with the exception that only a single
       line from the edit buffer (one ``buffer line'') was kept current at any
       time. This line was normally displayed on the next-to-last line of a
       terminal with cursor addressing (and the last line performed its normal
       visual functions for line-oriented commands and messages). In addition,
       some few commands behaved differently in open mode than in visual mode.
       POSIX.1-2008 requires conformance to historical practice.

       Historically, _e_x and _v_i implementations have expected text to proceed
       in the usual European/Latin order of left to right, top to bottom.
       There is no requirement in POSIX.1-2008 that this be the case. The
       specification was deliberately written using words like ``before'',
       ``after'', ``first'', and ``last'' in order to permit implementations
       to support the natural text order of the language.

       Historically, lines past the end of the edit buffer were marked with
       single <tilde> (''~~'') characters; that is, if the one-based display was
       20 lines in length, and the last line of the file was on line one, then
       lines 2-20 would contain only a single ''~~'' character.

       Historically, the _v_i editor attempted to display only complete lines at
       the bottom of the screen (it did display partial lines at the top of
       the screen). If a line was too long to fit in its entirety at the
       bottom of the screen, the screen lines where the line would have been
       displayed were displayed as single ''@@'' characters, instead of
       displaying part of the line. POSIX.1-2008 permits, but does not
       require, this behavior. Implementations are encouraged to attempt
       always to display a complete line at the bottom of the screen when
       doing scrolling or screen positioning by buffer lines.

       Historically, lines marked with ''@@'' were also used to minimize output
       to dumb terminals over slow lines; that is, changes local to the cursor
       were updated, but changes to lines on the screen that were not close to
       the cursor were simply marked with an ''@@'' sign instead of being updated
       to match the current text. POSIX.1-2008 permits, but does not require
       this feature because it is used ever less frequently as terminals
       become smarter and connections are faster.

   IInniittiiaalliizzaattiioonn iinn eexx aanndd vvii
       Historically, _v_i always had a line in the edit buffer, even if the edit
       buffer was ``empty''. For example:

        1. The _e_x command == executed from visual mode wrote ``1'' when the
           buffer was empty.

        2. Writes from visual mode of an empty edit buffer wrote files of a
           single character (a <newline>), while writes from _e_x mode of an
           empty edit buffer wrote empty files.

        3. Put and read commands into an empty edit buffer left an empty line
           at the top of the edit buffer.

       For consistency, POSIX.1-2008 does not permit any of these behaviors.

       Historically, _v_i did not always return the terminal to its original
       modes; for example, ICRNL was modified if it was not originally set.
       POSIX.1-2008 does not permit this behavior.

   CCoommmmaanndd DDeessccrriippttiioonnss iinn vvii
       Motion commands are among the most complicated aspects of _v_i to
       describe. With some exceptions, the text region and buffer type effect
       of a motion command on a _v_i command are described on a case-by-case
       basis. The descriptions of text regions in POSIX.1-2008 are not
       intended to imply direction; that is, an inclusive region from line _n
       to line _n+5 is identical to a region from line _n+5 to line _n.  This is
       of more than academic interest--movements to marks can be in either
       direction, and, if the wwrraappssccaann option is set, so can movements to
       search points. Historically, lines are always stored into buffers in
       text order; that is, from the start of the edit buffer to the end.
       POSIX.1-2008 requires conformance to historical practice.

       Historically, command counts were applied to any associated motion, and
       were multiplicative to any supplied motion count. For example, 22ccww is
       the same as cc22ww, and 22cc33ww is the same as cc66ww.  POSIX.1-2008 requires
       this behavior. Historically, _v_i commands that used bigwords, words,
       paragraphs, and sentences as objects treated groups of empty lines, or
       lines that contained only <blank> characters, inconsistently. Some
       commands treated them as a single entity, while others treated each
       line separately. For example, the ww, WW, and BB commands treated groups
       of empty lines as individual words; that is, the command would move the
       cursor to each new empty line. The ee and EE commands treated groups of
       empty lines as a single word; that is, the first use would move past
       the group of lines. The bb command would just beep at the user, or if
       done from the start of the line as a motion command, fail in unexpected
       ways. If the lines contained only (or ended with) <blank> characters,
       the ww and WW commands would just beep at the user, the EE and ee commands
       would treat the group as a single word, and the BB and bb commands would
       treat the lines as individual words. For consistency and simplicity of
       specification, POSIX.1-2008 requires that all _v_i commands treat groups
       of empty or blank lines as a single entity, and that movement through
       lines ending with <blank> characters be consistent with other
       movements.

       Historically, _v_i documentation indicated that any number of double-
       quotes were skipped after punctuation marks at sentence boundaries;
       however, implementations only skipped single-quotes. POSIX.1-2008
       requires both to be skipped.

       Historically, the first and last characters in the edit buffer were
       word boundaries. This historical practice is required by POSIX.1-2008.

       Historically, _v_i attempted to update the minimum number of columns on
       the screen possible, which could lead to misleading information being
       displayed.  POSIX.1-2008 makes no requirements other than that the
       current character being entered is displayed correctly, leaving all
       other decisions in this area up to the implementation.

       Historically, lines were arbitrarily folded between columns of any
       characters that required multiple column positions on the screen, with
       the exception of tabs, which terminated at the right-hand margin.
       POSIX.1-2008 permits the former and requires the latter.
       Implementations that do not arbitrarily break lines between columns of
       characters that occupy multiple column positions should not permit the
       cursor to rest on a column that does not contain any part of a
       character.

       The historical _v_i had a problem in that all movements were by buffer
       lines, not by display or screen lines. This is often the right thing to
       do; for example, single line movements, such as jj or kk, should work on
       buffer lines. Commands like ddjj, or jj.., where ..  is a change command,
       only make sense for buffer lines. It is not, however, the right thing
       to do for screen motion or scrolling commands like <control>-D,
       <control>-F, and HH.  If the window is fairly small, using buffer lines
       in these cases can result in completely random motion; for example,
       11<control>--DD can result in a completely changed screen, without any
       overlap. This is clearly not what the user wanted. The problem is even
       worse in the case of the HH, LL, and MM commands--as they position the
       cursor at the first non-<blank> of the line, they may all refer to the
       same location in large lines, and will result in no movement at all.

       In addition, if the line is larger than the screen, using buffer lines
       can make it impossible to display parts of the line--there are not any
       commands that do not display the beginning of the line in historical
       _v_i, and if both the beginning and end of the line cannot be on the
       screen at the same time, the user suffers. Finally, the page and half-
       page scrolling commands historically moved to the first non-<blank> in
       the new line. If the line is approximately the same size as the screen,
       this is inadequate because the cursor before and after a <control>-D
       command will refer to the same location on the screen.

       Implementations of _e_x and _v_i exist that do not have these problems
       because the relevant commands (<control>-B, <control>-D, <control>-F,
       <control>-U, <control>-Y, <control>-E, HH, LL, and MM)) operate on display
       (screen) lines, not (edit) buffer lines.

       POSIX.1-2008 does not permit this behavior by default because the
       standard developers believed that users would find it too confusing.
       However, historical practice has been relaxed. For example, _e_x and _v_i
       historically attempted, albeit sometimes unsuccessfully, to never put
       part of a line on the last lines of a screen; for example, if a line
       would not fit in its entirety, no part of the line was displayed, and
       the screen lines corresponding to the line contained single ''@@''
       characters. This behavior is permitted, but not required by
       POSIX.1-2008, so that it is possible for implementations to support
       long lines in small screens more reasonably without changing the
       commands to be oriented to the display (instead of oriented to the
       buffer). POSIX.1-2008 also permits implementations to refuse to edit
       any edit buffer containing a line that will not fit on the screen in
       its entirety.

       The display area (for example, the value of the wwiinnddooww edit option) has
       historically been ``grown'', or expanded, to display new text when
       local movements are done in displays where the number of lines
       displayed is less than the maximum possible. Expansion has historically
       been the first choice, when the target line is less than the maximum
       possible expansion value away. Scrolling has historically been the next
       choice, done when the target line is less than half a display away, and
       otherwise, the screen was redrawn. There were exceptions, however, in
       that _e_x commands generally always caused the screen to be redrawn.
       POSIX.1-2008 does not specify a standard behavior because there may be
       external issues, such as connection speed, the number of characters
       necessary to redraw as opposed to scroll, or terminal capabilities that
       implementations will have to accommodate.

       The current line in POSIX.1-2008 maps one-to-one to a buffer line in
       the file. The current column does not. There are two different column
       values that are described by POSIX.1-2008. The first is the current
       column value as set by many of the _v_i commands. This value is
       remembered for the lifetime of the editor. The second column value is
       the actual position on the screen where the cursor rests. The two are
       not always the same. For example, when the cursor is backed by a multi-
       column character, the actual cursor position on the screen has
       historically been the last column of the character in command mode, and
       the first column of the character in input mode.

       Commands that set the current line, but that do not set the current
       cursor value (for example, jj and kk) attempt to get as close as possible
       to the remembered column position, so that the cursor tends to restrict
       itself to a vertical column as the user moves around in the edit
       buffer. POSIX.1-2008 requires conformance to historical practice,
       requiring that the display location of the cursor on the display line
       be adjusted from the current column value as necessary to support this
       historical behavior.

       Historically, only a single line (and for some terminals, a single line
       minus 1 column) of characters could be entered by the user for the
       line-oriented commands; that is, ::, !!, //, or ??.  POSIX.1-2008 permits,
       but does not require, this limitation.

       Historically, ``soft'' errors in _v_i caused the terminal to be alerted,
       but no error message was displayed.  As a general rule, no error
       message was displayed for errors in command execution in _v_i, when the
       error resulted from the user attempting an invalid or impossible
       action, or when a searched-for object was not found.  Examples of soft
       errors included hh at the left margin, <control>-B or [[[[ at the
       beginning of the file, 22GG at the end of the file, and so on. In
       addition, errors such as %%, ]]]], }}, )), NN, nn, ff, FF, tt, and TT failing to
       find the searched-for object were soft as well. Less consistently, //
       and ??  displayed an error message if the pattern was not found, //, ??,
       NN, and nn displayed an error message if no previous regular expression
       had been specified, and ;; did not display an error message if no
       previous ff, FF, tt, or TT command had occurred. Also, behavior in this
       area might reasonably be based on a runtime evaluation of the speed of
       a network connection.  Finally, some implementations have provided
       error messages for soft errors in order to assist naive users, based on
       the value of a verbose edit option. POSIX.1-2008 does not list specific
       errors for which an error message shall be displayed. Implementations
       should conform to historical practice in the absence of any strong
       reason to diverge.

   PPaaggee BBaacckkwwaarrddss
       The <control>-B and <control>-F commands historically considered it an
       error to attempt to page past the beginning or end of the file, whereas
       the <control>-D and <control>-U commands simply moved to the beginning
       or end of the file. For consistency, POSIX.1-2008 requires the latter
       behavior for all four commands.  All four commands still consider it an
       error if the current line is at the beginning (<control>-B,
       <control>-U) or end (<control>-F, <control>-D) of the file.
       Historically, the <control>-B and <control>-F commands skip two lines
       in order to include overlapping lines when a single command is entered.
       This makes less sense in the presence of a _c_o_u_n_t, as there will be, by
       definition, no overlapping lines. The actual calculation used by
       historical implementations of the _v_i editor for <control>-B was:


           ((current first line) - count x (window edit option)) +2

       and for <control>-F was:


           ((current first line) + count x (window edit option)) -2

       This calculation does not work well when intermixing commands with and
       without counts; for example, 33<control>-F is not equivalent to entering
       the <control>-F command three times, and is not reversible by entering
       the <control>-B command three times. For consistency with other _v_i
       commands that take counts, POSIX.1-2008 requires a different
       calculation.

   SSccrroollll FFoorrwwaarrdd
       The 4BSD and System V implementations of _v_i differed on the initial
       value used by the ssccrroollll command. 4BSD used:


           ((window edit option) +1) /2

       while System V used the value of the ssccrroollll edit option. The System V
       version is specified by POSIX.1-2008 because the standard developers
       believed that it was more intuitive and permitted the user a method of
       setting the scroll value initially without also setting the number of
       lines that are displayed.

   SSccrroollll FFoorrwwaarrdd bbyy LLiinnee
       Historically, the <control>-E and <control>-Y commands considered it an
       error if the last and first lines, respectively, were already on the
       screen. POSIX.1-2008 requires conformance to historical practice.
       Historically, the <control>-E and <control>-Y commands had no effect in
       open mode. For simplicity and consistency of specification,
       POSIX.1-2008 requires that they behave as usual, albeit with a single
       line screen.

   CClleeaarr aanndd RReeddiissppllaayy
       The historical <control>-L command refreshed the screen exactly as it
       was supposed to be currently displayed, replacing any ''@@'' characters
       for lines that had been deleted but not updated on the screen with
       refreshed ''@@'' characters. The intent of the <control>-L command is to
       refresh when the screen has been accidentally overwritten; for example,
       by a wwrriittee command from another user, or modem noise.

   RReeddrraaww SSccrreeeenn
       The historical <control>-R command redisplayed only when necessary to
       update lines that had been deleted but not updated on the screen and
       that were flagged with ''@@'' characters. There is no requirement that the
       screen be in any way refreshed if no lines of this form are currently
       displayed. POSIX.1-2008 permits implementations to extend this command
       to refresh lines on the screen flagged with ''@@'' characters because they
       are too long to be displayed in the current framework; however, the
       current line and column need not be modified.

   SSeeaarrcchh ffoorr ttaaggssttrriinngg
       Historically, the first non-<blank> at or after the cursor was the
       first character, and all subsequent characters that were word
       characters, up to the end of the line, were included. For example, with
       the cursor on the leading <space> or on the ''##'' character in the text
       ""##bbaarr@@"", the tag was ""##bbaarr"".  On the character ''bb'' it was ""bbaarr"", and on
       the ''aa'' it was ""aarr"".  POSIX.1-2008 requires this behavior.

   RReeppllaaccee TTeexxtt wwiitthh RReessuullttss ffrroomm SShheellll CCoommmmaanndd
       Historically, the <<, >>, and !!  commands considered most cursor motions
       other than line-oriented motions an error; for example, the command
       >>//ffoooo<<CCRR>> succeeded, while the command >>ll failed, even though the text
       region described by the two commands might be identical. For
       consistency, all three commands only consider entire lines and not
       partial lines, and the region is defined as any line that contains a
       character that was specified by the motion.

   MMoovvee ttoo MMaattcchhiinngg CChhaarraacctteerr
       Other matching characters have been left implementation-defined in
       order to allow extensions such as matching ''<<'' and ''>>'' for searching
       HTML, or ##iiffddeeff, ##eellssee, and ##eennddiiff for searching C source.

   RReeppeeaatt SSuubbssttiittuuttiioonn
       POSIX.1-2008 requires that any cc and gg flags specified to the previous
       substitute command be ignored; however, the rr flag may still apply, if
       supported by the implementation.

   RReettuurrnn ttoo PPrreevviioouuss ((CCoonntteexxtt oorr SSeeccttiioonn))
       The [[[[, ]]]], ((, )), {{, and }} commands are all affected by ``section
       boundaries'', but in some historical implementations not all of the
       commands recognize the same section boundaries. This is a bug, not a
       feature, and a unique section-boundary algorithm was not described for
       each command. One special case that is preserved is that the sentence
       command moves to the end of the last line of the edit buffer while the
       other commands go to the beginning, in order to preserve the
       traditional character cut semantics of the sentence command.
       Historically, _v_i section boundaries at the beginning and end of the
       edit buffer were the first non-<blank> on the first and last lines of
       the edit buffer if one exists; otherwise, the last character of the
       first and last lines of the edit buffer if one exists. To increase
       consistency with other section locations, this has been simplified by
       POSIX.1-2008 to the first character of the first and last lines of the
       edit buffer, or the first and the last lines of the edit buffer if they
       are empty.

       Sentence boundaries were problematic in the historical _v_i.  They were
       not only the boundaries as defined for the section and paragraph
       commands, but they were the first non-<blank> that occurred after those
       boundaries, as well. Historically, the _v_i section commands were
       documented as taking an optional window size as a _c_o_u_n_t preceding the
       command. This was not implemented in historical versions, so
       POSIX.1-2008 requires that the _c_o_u_n_t repeat the command, for
       consistency with other _v_i commands.

   RReeppeeaatt
       Historically, mapped commands other than text input commands could not
       be repeated using the ppeerriioodd command. POSIX.1-2008 requires conformance
       to historical practice.

       The restrictions on the interpretation of special characters (for
       example, <control>-H) in the repetition of text input mode commands is
       intended to match historical practice. For example, given the input
       sequence:


           iab<control>-H<control>-H<control>-Hdef<escape>

       the user should be informed of an error when the sequence is first
       entered, but not during a command repetition. The character <control>-T
       is specifically exempted from this restriction. Historical
       implementations of _v_i ignored <control>-T characters that were input in
       the original command during command repetition. POSIX.1-2008 prohibits
       this behavior.

   FFiinndd RReegguullaarr EExxpprreessssiioonn
       Historically, commands did not affect the line searched to or from if
       the motion command was a search (//, ??, NN, nn) and the final position was
       the start/end of the line. There were some special cases and _v_i was not
       consistent. POSIX.1-2008 does not permit this behavior, for
       consistency. Historical implementations permitted but were unable to
       handle searches as motion commands that wrapped (that is, due to the
       edit option wwrraappssccaann) to the original location. POSIX.1-2008 requires
       that this behavior be treated as an error.

       Historically, the syntax ""//RREE//00"" was used to force the command to cut
       text in line mode. POSIX.1-2008 requires conformance to historical
       practice.

       Historically, in open mode, a zz specified to a search command
       redisplayed the current line instead of displaying the current screen
       with the current line highlighted. For consistency and simplicity of
       specification, POSIX.1-2008 does not permit this behavior.

       Historically, trailing zz commands were permitted and ignored if entered
       as part of a search used as a motion command. For consistency and
       simplicity of specification, POSIX.1-2008 does not permit this
       behavior.

   EExxeeccuuttee aann eexx CCoommmmaanndd
       Historically, _v_i implementations restricted the commands that could be
       entered on the colon command line (for example, aappppeenndd and cchhaannggee), and
       some other commands were known to cause them to fail catastrophically.
       For consistency, POSIX.1-2008 does not permit these restrictions. When
       executing an _e_x command by entering ::, it is not possible to enter a
       <newline> as part of the command because it is considered the end of
       the command.  A different approach is to enter _e_x command mode by using
       the _v_i QQ command (and later resuming visual mode with the _e_x vvii
       command). In _e_x command mode, the single-line limitation does not
       exist. So, for example, the following is valid:


           Q
           s/break here/break\
           here/
           vi

       POSIX.1-2008 requires that, if the _e_x command overwrites any part of
       the screen that would be erased by a refresh, _v_i pauses for a character
       from the user. Historically, this character could be any character; for
       example, a character input by the user before the message appeared, or
       even a mapped character. This is probably a bug, but implementations
       that have tried to be more rigorous by requiring that the user enter a
       specific character, or that the user enter a character after the
       message was displayed, have been forced by user indignation back into
       historical behavior. POSIX.1-2008 requires conformance to historical
       practice.

   SShhiifftt LLeefftt ((RRiigghhtt))
       Refer to the Rationale for the !!  and // commands. Historically, the <<
       and >> commands sometimes moved the cursor to the first non-<blank> (for
       example if the command was repeated or with __ as the motion command),
       and sometimes left it unchanged. POSIX.1-2008 does not permit this
       inconsistency, requiring instead that the cursor always move to the
       first non-<blank>.  Historically, the << and >> commands did not support
       buffer arguments, although some implementations allow the specification
       of an optional buffer. This behavior is neither required nor disallowed
       by POSIX.1-2008.

   EExxeeccuuttee
       Historically, buffers could execute other buffers, and loops, infinite
       and otherwise, were possible. POSIX.1-2008 requires conformance to
       historical practice. The *_b_u_f_f_e_r syntax of _e_x is not required in _v_i,
       because it is not historical practice and has been used in some _v_i
       implementations to support additional scripting languages.

   RReevveerrssee CCaassee
       Historically, the ~~ command ignored any associated _c_o_u_n_t, and acted
       only on the characters in the current line. For consistency with other
       _v_i commands, POSIX.1-2008 requires that an associated _c_o_u_n_t act on the
       next _c_o_u_n_t characters, and that the command move to subsequent lines if
       warranted by _c_o_u_n_t, to make it possible to modify large pieces of text
       in a reasonably efficient manner. There exist _v_i implementations that
       optionally require an associated motion command for the ~~ command.
       Implementations supporting this functionality are encouraged to base it
       on the ttiillddeeddoopp edit option and handle the text regions and cursor
       positioning identically to the yyaannkk command.

   AAppppeenndd
       Historically, _c_o_u_n_ts specified to the AA, aa, II, and ii commands repeated
       the input of the first line _c_o_u_n_t times, and did not repeat the
       subsequent lines of the input text. POSIX.1-2008 requires that the
       entire text input be repeated _c_o_u_n_t times.

   MMoovvee BBaacckkwwaarrdd ttoo PPrreecceeddiinngg WWoorrdd
       Historically, _v_i became confused if word commands were used as motion
       commands in empty files. POSIX.1-2008 requires that this be an error.
       Historical implementations of _v_i had a large number of bugs in the word
       movement commands, and they varied greatly in behavior in the presence
       of empty lines, ``words'' made up of a single character, and lines
       containing only <blank> characters. For consistency and simplicity of
       specification, POSIX.1-2008 does not permit this behavior.

   CChhaannggee ttoo EEnndd--ooff--LLiinnee
       Some historical implementations of the CC command did not behave as
       described by POSIX.1-2008 when the $$ key was remapped because they were
       implemented by pushing the $$ key onto the input queue and reprocessing
       it. POSIX.1-2008 does not permit this behavior. Historically, the CC, SS,
       and ss commands did not copy replaced text into the numeric buffers. For
       consistency and simplicity of specification, POSIX.1-2008 requires that
       they behave like their respective cc commands in all respects.

   DDeelleettee
       Historically, lines in open mode that were deleted were scrolled up,
       and an @@ glyph written over the beginning of the line. In the case of
       terminals that are incapable of the necessary cursor motions, the
       editor erased the deleted line from the screen. POSIX.1-2008 requires
       conformance to historical practice; that is, if the terminal cannot
       display the ''@@'' character, the line cannot remain on the screen.

   DDeelleettee ttoo EEnndd--ooff--LLiinnee
       Some historical implementations of the DD command did not behave as
       described by POSIX.1-2008 when the $$ key was remapped because they were
       implemented by pushing the $$ key onto the input queue and reprocessing
       it. POSIX.1-2008 does not permit this behavior.

   JJooiinn
       An historical oddity of _v_i is that the commands JJ, 11JJ, and 22JJ are all
       equivalent. POSIX.1-2008 requires conformance to historical practice.
       The _v_i JJ command is specified in terms of the _e_x jjooiinn command with an
       _e_x command _c_o_u_n_t value. The address correction for a _c_o_u_n_t that is past
       the end of the edit buffer is necessary for historical compatibility
       for both _e_x and _v_i.

   MMaarrkk PPoossiittiioonn
       Historical practice is that only lowercase letters, plus backquote and
       single-quote, could be used to mark a cursor position. POSIX.1-2008
       requires conformance to historical practice, but encourages
       implementations to support other characters as marks as well.

   RReeppeeaatt RReegguullaarr EExxpprreessssiioonn FFiinndd ((FFoorrwwaarrdd aanndd RReevveerrssee))
       Historically, the NN and nn commands could not be used as motion
       components for the cc command. With the exception of the ccNN command,
       which worked if the search crossed a line boundary, the text region
       would be discarded, and the user would not be in text input mode. For
       consistency and simplicity of specification, POSIX.1-2008 does not
       permit this behavior.

   IInnsseerrtt EEmmppttyy LLiinnee ((BBeellooww aanndd AAbboovvee))
       Historically, counts to the OO and oo commands were used as the number of
       physical lines to open, if the terminal was dumb and the sslloowwooppeenn
       option was not set. This was intended to minimize traffic over slow
       connections and repainting for dumb terminals. POSIX.1-2008 does not
       permit this behavior, requiring that a _c_o_u_n_t to the open command behave
       as for other text input commands. This change to historical practice
       was made for consistency, and because a superset of the functionality
       is provided by the sslloowwooppeenn edit option.

   PPuutt ffrroomm BBuuffffeerr ((FFoolllloowwiinngg aanndd BBeeffoorree))
       Historically, _c_o_u_n_ts to the pp and PP commands were ignored if the buffer
       was a line mode buffer, but were (mostly) implemented as described in
       POSIX.1-2008 if the buffer was a character mode buffer. Because
       implementations exist that do not have this limitation, and because
       pasting lines multiple times is generally useful, POSIX.1-2008 requires
       that _c_o_u_n_t be supported for all pp and PP commands.

       Historical implementations of _v_i were widely known to have major
       problems in the pp and PP commands, particularly when unusual regions of
       text were copied into the edit buffer. The standard developers viewed
       these as bugs, and they are not permitted for consistency and
       simplicity of specification.

       Historically, a PP or pp command (or an _e_x ppuutt command executed from open
       or visual mode) executed in an empty file, left an empty line as the
       first line of the file. For consistency and simplicity of
       specification, POSIX.1-2008 does not permit this behavior.

   RReeppllaaccee CChhaarraacctteerr
       Historically, the rr command did not correctly handle the _e_r_a_s_e and _w_o_r_d
       _e_r_a_s_e characters as arguments, nor did it handle an associated _c_o_u_n_t
       greater than 1 with a <carriage-return> argument, for which it replaced
       _c_o_u_n_t characters with a single <newline>.  POSIX.1-2008 does not permit
       these inconsistencies.

       Historically, the rr command permitted the <control>-V escaping of
       entered characters, such as <ESC> and the <carriage-return>; however,
       it required two leading <control>-V characters instead of one.
       POSIX.1-2008 requires that this be changed for consistency with the
       other text input commands of _v_i.

       Historically, it is an error to enter the rr command if there are less
       than _c_o_u_n_t characters at or after the cursor in the line. While a
       reasonable and unambiguous extension would be to permit the rr command
       on empty lines, it would require that too large a _c_o_u_n_t be adjusted to
       match the number of characters at or after the cursor for consistency,
       which is sufficiently different from historical practice to be avoided.
       POSIX.1-2008 requires conformance to historical practice.

   RReeppllaaccee CChhaarraacctteerrss
       Historically, if there were aauuttooiinnddeenntt characters in the line on which
       the RR command was run, and aauuttooiinnddeenntt was set, the first <newline>
       would be properly indented and no characters would be replaced by the
       <newline>.  Each additional <newline> would replace _n characters, where
       _n was the number of characters that were needed to indent the rest of
       the line to the proper indentation level. This behavior is a bug and is
       not permitted by POSIX.1-2008.

   UUnnddoo
       Historical practice for cursor positioning after undoing commands was
       mixed. In most cases, when undoing commands that affected a single
       line, the cursor was moved to the start of added or changed text, or
       immediately after deleted text. However, if the user had moved from the
       line being changed, the column was either set to the first non-<blank>,
       returned to the origin of the command, or remained unchanged. When
       undoing commands that affected multiple lines or entire lines, the
       cursor was moved to the first character in the first line restored. As
       an example of how inconsistent this was, a search, followed by an oo
       text input command, followed by an uunnddoo would return the cursor to the
       location where the oo command was entered, but a ccww command followed by
       an oo command followed by an uunnddoo would return the cursor to the first
       non-<blank> of the line. POSIX.1-2008 requires the most useful of these
       behaviors, and discards the least useful, in the interest of
       consistency and simplicity of specification.

   YYaannkk
       Historically, the yyaannkk command did not move to the end of the motion if
       the motion was in the forward direction. It moved to the end of the
       motion if the motion was in the backward direction, except for the __
       command, or for the GG and '' commands when the end of the motion was on
       the current line. This was further complicated by the fact that for a
       number of motion commands, the yyaannkk command moved the cursor but did
       not update the screen; for example, a subsequent command would move the
       cursor from the end of the motion, even though the cursor on the screen
       had not reflected the cursor movement for the yyaannkk command.
       POSIX.1-2008 requires that all yyaannkk commands associated with backward
       motions move the cursor to the end of the motion for consistency, and
       specifically, to make '' commands as motions consistent with search
       patterns as motions.

   YYaannkk CCuurrrreenntt LLiinnee
       Some historical implementations of the YY command did not behave as
       described by POSIX.1-2008 when the ''__'' key was remapped because they
       were implemented by pushing the ''__'' key onto the input queue and
       reprocessing it. POSIX.1-2008 does not permit this behavior.

   RReeddrraaww WWiinnddooww
       Historically, the zz command always redrew the screen. This is permitted
       but not required by POSIX.1-2008, because of the frequent use of the zz
       command in macros such as mmaapp nn nnzz..  for screen positioning, instead of
       its use to change the screen size.  The standard developers believed
       that expanding or scrolling the screen offered a better interface for
       users. The ability to redraw the screen is preserved if the optional
       new window size is specified, and in the <control>-L and <control>-R
       commands.

       The semantics of zz^^ are confusing at best. Historical practice is that
       the screen before the screen that ended with the specified line is
       displayed. POSIX.1-2008 requires conformance to historical practice.

       Historically, the zz command would not display a partial line at the top
       or bottom of the screen. If the partial line would normally have been
       displayed at the bottom of the screen, the command worked, but the
       partial line was replaced with ''@@'' characters. If the partial line
       would normally have been displayed at the top of the screen, the
       command would fail. For consistency and simplicity of specification,
       POSIX.1-2008 does not permit this behavior.

       Historically, the zz command with a line specification of 1 ignored the
       command. For consistency and simplicity of specification, POSIX.1-2008
       does not permit this behavior.

       Historically, the zz command did not set the cursor column to the first
       non-<blank> for the character if the first screen was to be displayed,
       and was already displayed. For consistency and simplicity of
       specification, POSIX.1-2008 does not permit this behavior.

   IInnppuutt MMooddee CCoommmmaannddss iinn vvii
       Historical implementations of _v_i did not permit the user to erase more
       than a single line of input, or to use normal erase characters such as
       _l_i_n_e _e_r_a_s_e, _w_o_r_d_e_r_a_s_e, and _e_r_a_s_e to erase aauuttooiinnddeenntt characters. As
       there exist implementations of _v_i that do not have these limitations,
       both behaviors are permitted, but only historical practice is required.
       In the case of these extensions, _v_i is required to pause at the
       aauuttooiinnddeenntt and previous line boundaries.

       Historical implementations of _v_i updated only the portion of the screen
       where the current cursor character was displayed. For example, consider
       the _v_i input keystrokes:


           iabcd<escape>0C<tab>

       Historically, the <tab> would overwrite the characters ""aabbccdd"" when it
       was displayed. Other implementations replace only the ''aa'' character
       with the <tab>, and then push the rest of the characters ahead of the
       cursor. Both implementations have problems. The historical
       implementation is probably visually nicer for the above example;
       however, for the keystrokes:


           iabcd<ESC>0R<tab><ESC>

       the historical implementation results in the string ""bbccdd"" disappearing
       and then magically reappearing when the <ESC> character is entered.
       POSIX.1-2008 requires the former behavior when overwriting erase-
       columns--that is, overwriting characters that are no longer logically
       part of the edit buffer--and the latter behavior otherwise.

       Historical implementations of _v_i discarded the <control>-D and
       <control>-T characters when they were entered at places where their
       command functionality was not appropriate. POSIX.1-2008 requires that
       the <control>-T functionality always be available, and that <control>-D
       be treated as any other key when not operating on aauuttooiinnddeenntt
       characters.

   NNUULL
       Some historical implementations of _v_i limited the number of characters
       entered using the NUL input character to 256 bytes. POSIX.1-2008
       permits this limitation; however, implementations are encouraged to
       remove this limit.

   <<ccoonnttrrooll>>--DD
       See also Rationale for the input mode command <newline>.  The hidden
       assumptions in the <control>-D command (and in the _v_i aauuttooiinnddeenntt
       specification in general) is that <space> characters take up a single
       column on the screen and that <tab> characters are comprised of an
       integral number of <space> characters.

   <<nneewwlliinnee>>
       Implementations are permitted to rewrite aauuttooiinnddeenntt characters in the
       line when <newline>, <carriage-return>, <control>-D, and <control>-T
       are entered, or when the sshhiifftt commands are used, because historical
       implementations have both done so and found it necessary to do so. For
       example, a <control>-D when the cursor is preceded by a single <tab>,
       with ttaabbssttoopp set to 8, and sshhiiffttwwiiddtthh set to 3, will result in the
       <tab> being replaced by several <space> characters.

   <<ccoonnttrrooll>>--TT
       See also the Rationale for the input mode command <newline>.
       Historically, <control>-T only worked if no non-<blank> characters had
       yet been input in the current input line. In addition, the characters
       inserted by <control>-T were treated as aauuttooiinnddeenntt characters, and
       could not be erased using normal user erase characters.  Because
       implementations exist that do not have these limitations, and as moving
       to a column boundary is generally useful, POSIX.1-2008 requires that
       both limitations be removed.

   <<ccoonnttrrooll>>--VV
       Historically, _v_i used ^^VV, regardless of the value of the literal-next
       character of the terminal.  POSIX.1-2008 requires conformance to
       historical practice.

       The uses described for <control>-V can also be accomplished with
       <control>-Q, which is useful on terminals that use <control>-V for the
       down-arrow function. However, most historical implementations use
       <control>-Q for the _t_e_r_m_i_o_s START character, so the editor will
       generally not receive the <control>-Q unless ssttttyy iixxoonn mode is set to
       off. (In addition, some historical implementations of _v_i explicitly set
       iixxoonn mode to on, so it was difficult for the user to set it to off.)
       Any of the command characters described in POSIX.1-2008 can be made
       ineffective by their selection as _t_e_r_m_i_o_s control characters, using the
       _s_t_t_y utility or other methods described in the System Interfaces volume
       of POSIX.1-2017.

   <<EESSCC>>
       Historically, SIGINT alerted the terminal when used to end input mode.
       This behavior is permitted, but not required, by POSIX.1-2008.

FFUUTTUURREE DDIIRREECCTTIIOONNSS
       None.

SSEEEE AALLSSOO
       _e_d, _e_x, _s_t_t_y

       The Base Definitions volume of POSIX.1-2017, _S_e_c_t_i_o_n _1_2_._2, _U_t_i_l_i_t_y
       _S_y_n_t_a_x _G_u_i_d_e_l_i_n_e_s

CCOOPPYYRRIIGGHHTT
       Portions of this text are reprinted and reproduced in electronic form
       from IEEE Std 1003.1-2017, Standard for Information Technology --
       Portable Operating System Interface (POSIX), The Open Group Base
       Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the
       Institute of Electrical and Electronics Engineers, Inc and The Open
       Group.  In the event of any discrepancy between this version and the
       original IEEE and The Open Group Standard, the original IEEE and The
       Open Group Standard is the referee document. The original Standard can
       be obtained online at http://www.opengroup.org/unix/online.html .

       Any typographical or formatting errors that appear in this page are
       most likely to have been introduced during the conversion of the source
       files to man page format. To report such errors, see
       https://www.kernel.org/doc/man-pages/reporting_bugs.html .



IEEE/The Open Group                  2017                                VI(1)
