ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.3)
_______________________________________________________________________________
    nc [<foreground_color> | -u] [<background_color>]
    "next color boundary"
    
    DESCRIPTION:
        'nc'  moves the cursor to the next color boundary within the file being
        edited.   The boundary is either the beginning of a colored area or the
        end.   Colored areas may have internal boundaries where colors  change.
        'nc' always positions to the first column on a line.

        The  nc color is generally used after a some sort of script which  uses
        the 'ca' command to color the file has done some highlighting. You want
        to  move  the cursor to the next colored area.  A key definition  which
        executes  'nc' will provide this functionality.  As of release 2.5, the
        default  key definitions for Alt-r and Alt-u execute the next color and
        previous color commands respectively.
        
        nc  with  no  parameters moves the cursor to the next  color  boundary.
        Specifying just the foreground color moves the cursor to the next color
        boundary  with that foreground color.  Specifying just background color
        or  both  moves  the cursor to the next color  boundary  which  matches
        appropriately.

        Either  the  foreground  color, the background color, or  both  may  be
        specified.   To  specify  only the background color, code  ""  for  the
        foreground color.

   PARAMETERS

        <foreground_color>
                This is the foreground color to be searched for.  The color may
                be  a  named  color  such as red or a hex  RGB  value  such  as
                '#654321'.   Note  that  RGB  values start with a  #  and  must
                therefore  be  enclosed  in  quotes.  This  avoids  them  being
                mistaken  for a comment.  The cursor will be moved to the  next
                color boundary with this value as the foreground color.

                If  -u (under cursor) is specified as the forground color,  the
                background  color  is ignored if supplied.  In this  case,  the
                foreground  / background color combination under the cursor  is
                determined  and  the  next color boundary with  this  color  is
                searched  for.  For example: If the cursor is over text colored
                red  over  blue and 'nc -u' is executed, this is equivalent  to
                'nc red blue'. If 'nc -u' is used over an uncolored region, the
                command is equivalent to 'nc' with no parameters. That is, find
                the next color boundary.
                

        <background_color>
                This  is  the  background color to be searched  for.   The  is
                specified the same way as foreground color.

   NOTES:
        In cases where one colored area has overlaid  another color area it may be
        possible that the nc command will find a color boundary where the color is
        not actually visible.
        For example:  [8,12],[8,15]ca blue;[8,1]dr;tr;ca red;
        will show all red, but a "nc blue" command will find the hidden blue area.
        This behavior is under review and may change in future releases.

        Unlike  a find command, nc does not remember the last color searched  for.
        'nc  red'  will find the next red text.  If you then execute just an  'nc'
        command, the next color boundary will be found regardless of what color it
        is. This behavior is also under review.


   EXAMPLES: 
        kd *r nc ke    # go to next color boundary with Alt-r
        kd *u pc ke    # go to previous color boundary with Alt-u
    
    RELATED HELP FILES:
        ca            (Color Area)       
        pc            (Previous Color)   
        bgc           (Background Color) 
        fgc           (Foreground Color) 
        
        support       (customer support) 
        

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