7.0;s (substitute) *DM*, revision 7.0, 83/08/16
S (SUBSTITUTE) *DM* -- Substitute text.
usage: [range]s[[/[string1]]/string2]


FORMAT

  [range]S[[/[string1]]/string2]


  The S command substitutes one literal string for a string described by a
  regular expression (see HELP PATTERNS) over a defined text range.
  The command does not move the cursor or the window, but does update the
  window when the substitution is completed.  Strings used with this command
  are also saved for later use (see below).

  All substitutions are case sensitive, unlike searches, which ignore case
  unless told otherwise.  Substitution case sensitivity cannot be disabled.


ARGUMENTS

  If no arguments are specified, the previous substitution will be repeated
  from the current cursor position to the end of the line.

  range
  (optional)       Specify range of text in which substitution is to be made.
                   Type HELP DM RANGE for details.
                   Default if omitted: use current cursor position to end of
                                       line

  string1
  (optional)       Specify string to be replaced in the form of a regular
                   expression (see HELP PATTERNS).  If this argument is omitted
                   but the opening delimiter (/) is used (i.e., "S//string2/"),
                   then string1 defaults to the string1 used in the last
                   SEARCH operation.  If the delimiter is also omitted
                   (i.e., "S/string2/"), then string1 defaults to the string
                   used in the last SUBSTITUTION operation.
                   Default if omitted: see above

  string2
  (optional)       Specify literal replacement string.  This is NOT a regular
                   expression).  An "&" can be used to denote string1.  If
                   'string1' is present, then 'string2' is required.
                   Default if omitted: repeat last substitution command


EXAMPLES

  1. CTRL/T                          Move to first character in the pad.
     <MARK>                          Place a mark.
     CTRL/B                          Move to last character in the pad.
     <CMD> s/Fielding/Tom Jones/     Replace the string "Fielding" with
                                      "Tom Jones" throughout the marked
                                      range (in this case, the entire pad).

  2. <CMD> s/Tom/& Jones/            Replace "Tom" with "Tom Jones".
                                      Since no range was marked or specified,
                                      the replacement takes effect from
                                      the current cursor position to the
                                      end of the line.


RELATED TOPICS

  More information is available.  Type:

    - HELP DM RANGE
      for details about text editing ranges.

    - HELP DM COMMANDS
      for a list of other pad editing commands

    - HELP PATTERNS
      for details about regular expressions.