ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.4)
_______________________________________________________________________________
    s [[/[<srchpat>]]/[<reppat>][/]]
    "substitute"
    
    DESCRIPTION:
        's'  is  used  to  replace  all  occurrences  of  a given string with a
        replacement string, within a defined region of text. 
        
        If a text region  has  been  marked  and  optionally  highlighted,  the
        search   and   replace  operation  is  performed  within  that  region,
        excluding the character directly under the cursor.  If no  text  region
        has  been  so  marked,  the  region  is defined as the from the current
        cursor position to the end of the line.  If a rectangular  text  region
        has been highlighted, 's' operates only on the text in that region. 
        
        The arguments to s can be in one of several forms:
        
                s/<srchpat>/<reppat>/   <srchpat> and    <reppat>    are   both
                                        non-null;   <srchpat>  is   a   regular
                                        expression;   <reppat>  is treated as a
                                        literal string;  all occurrences  of  a
                                        match   with   <srchpat>   within   the
                                        effected  region  are   replaced   with
                                        <reppat>
                                        
                s//<reppat>/            no explicit  search  pattern  is given;
                                        s uses the regular expression  used  in
                                        the most recent search operation
                                        
                s/<reppat>/             no explicit  search  pattern  is given,
                                        and the first search pattern  delimiter
                                        "/"   is   not  present;   s  uses  the
                                        <srchpat> regular  expression  used  in
                                        the   most   recent  search-and-replace
                                        operation
                                        
                s/<srchpat>//           replaces all occurrences  of  <srchpat>
                                        within  the  effected  range  with  the
                                        null   string;    in    other    words,
                                        occurrences  of  matches with <srchpat>
                                        are removed
        
        If '&' appears in <reppat>, '&' is interpreted to mean <srchpat>.   For
        example,  "s/Smith/Mr.  John  &/"  is  equivalent  to "s/Smith/Mr. John
        Smith/". 
        
        The Ce implementation of positioning after a substitute command places
        the cursor at the last char of the last place it did a substitute.

    
    RELATED HELP FILES:
        /             (Forwards Search)      
        \ or ?        (Backwards Search)     
        abrt          (Abort)                
        sq            (Search Quit)          
        re            (Regular Expression)   
        so            (Substitute Once)      
        
        regionsCon    (Text Regions)         
        regexpCon     (regular expression)   
        
        support       (customer support)     


_______________________________________________________________________________
  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.