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.