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.