7.0;s (substitute) *DM*, revision 7.0, 83/08/16
S (SUBSTITUTE) -- Substitute all occurrences of matched string in defined range.
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 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.    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.