SYNTAX            : ARG R STRING 1 ESC STRING 2 ESC
                  : ARG R ESC STRING 2 ESC

RESULTING ARGUMENT: None

FUNCTION          : Replace a character string by another character string
                    as many times as specified, or as many times as the first
                    character string exists (whichever is smaller). Search
                    starts at the current position in the buffer. After
                    execution, the cursor (and implicitly the value of  . )
                    is positioned immediately after the last string replaced.

                    The first string immediately follows the command in the
                    command sequence, and is terminated by an ESC. The
                    second string immediately follows that ESC, and is in
                    turn terminated by another ESC.

                    A negative argument forces backward search in the buffer.
                    In these cases, the cursor is positioned before the last
                    string replaced (counting backwards!).

                    If not all requested matches are found, an error is
                    raised.

ARGUMENT          : The number of times to perform the replace-action.

DEFAULT           : 1

EXAMPLE           : 7 r hello ESC world ESC
                    Will replace the string hello by world seven times.

NOTE 1            : Search-behaviour is governed by the Search Mode setting
                    (see CTRL_X)

NOTE 2            : If the first string is empty (the terminating ESC
                    follows the command, as in r ESC world ESC) then the
                    previous search string is reused.

NOTE 3            : The search string (used for both search and replace
                    commands) is accessable in register _ at all times.

NOTE 4            : The ESC character must not occur in either search- or
                    replacement string.

NOTE 5            : The RETURN character is allowed anywhere in the search-
                    or replacement string.

MATRIX