ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.4)
_______________________________________________________________________________
    Concept:  text regions.
    DESCRIPTION:
        A region is a portion of text upon which an operation is performed. 
        
        There are three types of regions:
        
            EXPLICIT CONTINUOUS REGION (Marked and dragged)
                This  is  a  region  defined  using  the  'dr'  (define region)
                command.  Such a region starts at the point marked by 'dr'  and
                includes  all  text up to BUT NOT INCLUDING the character under
                the cursor.  By default, the function keys F1 and Shift/F1  are
                defined to execute the "mark" command. 

                More  exactly, the mark placed by the dr and the cursor is just
                before  the position marked.  Thus, if a mark is placed and the
                cursor  moved  closer to the beginning of the file, the  region
                defined would not include the mark and would include the cursor
                under  the  character.  The result of this behavior is that  it
                does  not  matter whether you mark a region by marking (dr)  at
                the  top position and move the cursor to the bottom position or
                mark  at  the  bottom position and move the cursor to  the  top
                position.  The same region is marked.
            
            EXPLICIT CONTINUOUS REGION (defined)
                This  is  a  region  defined  using  two  positioning  commands
                separated  by  a comma.  For example, 1,$xc defines the  region
                from the first column of the first line of the file to the last
                character  on  the last line of the file and executes the  copy
                (xc)  command with this region defined.  The 1 and the '$'  can
                be  replaced  with  any  positioning   commands.   For  example
                "[5,6],[20,25]echo"  will  highlight  the region  from  line  5
                column  6  to line 20 column 25.  The comma sets a mark at  the
                position  defined  in  the first positioning command  and  then
                resets  the current cursor position back to where it was before
                the  first  positioning command.  This can best be  illustrated
                with    the    following   example.   The   command    sequence
                "/abc/,/def/echo"  will start searching from the current cursor
                position  for  the string "abc".  When it finds it,  the  comma
                sets a mark just before the 'a' and returns the cursor position
                to  the current position.  Thus the search for "def" begins  at
                the same place the search for "abc" began.  In contrast to this
                is  the sequence "/abc/dr;/def/echo.  This sequence starts  the
                search  for "def" at the position where "abc" was found instead
                of the position where the search for "abc" began.

            IMPLICIT CONTINUOUS REGION
                This  is  a  default region for a command.  For example, if the
                'xc' (text copy) command is issued without  a  'dr'  mark,  the
                default  region  starts at the cursor location and includes all
                text  up to and including the end of the line.  The Copy  (xc),
                Cut  (xd), Bang (!), Substitute (s and so), Change Case (case),
                Remove  tabs  (untab),  and Text Flow (tf)  commands  use  this
                implicit region.
            
            RECTANGULAR REGION
                A rectangular region is defined by the  positions  of  (i)  the
                point   that   was  marked  via  'dr'  and  (ii)  the  position
                immediately to the left of the cursor. 
                
                To illustrate, place the cursor directly on this X,  mark  that
                spot  by  pressing  'Shift/F1',  and  move  the  cursor around.
                Observe that the  highlighted  region  is  rectangular,  EXCEPT
                when  the  cursor  is  in  the exact same column as the initial
                mark (in this case, directly above or below the X). 

                A rectangular region may be defined with commands the same  way
                as  an explicit rectangular region.  The Copy (xc) and Cut (xd)
                commands have a "-r" parameter to specify that the region is to
                be  treated as rectangular.  To define a rectangular region for
                other  commands  an  echo -r should be placed  in  the  command
                stream.  For example:
                "[5,5],[20,30]echo -r;! -c -m wc"

        
        The F1 and F1S function keys are defined by default as follows:
        
            kd F1 dr;echo ke
            kd F1S dr;echo -r ke
        
        Both definitions include the 'echo' command.   'echo'  is  what  causes
        the  highlight to be present.  'echo -r' causes a rectangular highlight
        to be present. 
    
    RELATED HELP FILES:
        abrt          (Abort)                
        dr            (Define Region)        
        echo          (Highlight Text)       
        gm            (Go to Mark)           
        rm            (Re-Mark)              
        $             (Dollar)               
        <num>         (Line Number)          
        =             (Position)             
        [             (Character Position)   
        /             (Forward Search)       
        \ or ?        (Backward Search)      
        !             (bang )                
        xc            (Copy )                
        xd            (Cut  )                
        xp            (Paste)                

        regexpCon     (regular expressions)  
        
        support       (customer support)     

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