COPY_TEXT

  Copies the text of a string, range, or buffer, putting it before the
  current position in the current buffer.  The text is entered according to
  the current mode (INSERT or OVERSTRIKE).

  Syntax

     [range1 := ] COPY_TEXT ({string | range2 | buffer})

  Parameters

     range1               A range where the copied text has been placed.

     string               A string you want to copy.

     range2               A range containing the text you want to copy.  The
                          range is NOT removed or destroyed.

     buffer               A buffer containing the text you want to copy.
                          The buffer is NOT removed or destroyed.

  Comments

  If the current buffer is in insert mode, the text is inserted before the
  current position in the buffer.  If the current buffer is in overstrike
  mode, the text replaces existing text starting at the current position and
  continuing for the length of the string, range, or buffer.

  You cannot add a buffer or range to itself.

  If the current buffer is mapped to a visible window, COPY_TEXT causes
  DECTPU to synchronize the active editing point with the active cursor
  position.  As a result, DECTPU may insert padding blanks if the cursor
  position is not on a character.

  Examples

  1.  COPY_TEXT ("Very like a whale");

      If the buffer is set to insert mode, this statement inserts the text
      string before the current position in the current buffer.

  2.  COPY_TEXT (ASCII(10));

      If the buffer is set to overstrike mode, this statement causes the
      ASCII character for LINE FEED to replace the current character in the
      current buffer.

  Related topics

     MOVE_TEXT   SET_INSERT   SET_OVERSTRIKE