ARPUS/ce, Version 2.6.2 (03/10/05) (SCCS 1.4) _______________________________________________________________________________ bl [-d] [<l> <r>] "balance delimiters" DESCRIPTION: Use 'bl' to determine whether a pair of delimiters (such as '[' and ']' or 'begin' and 'end') are balanced in a file. The command can be used in several forms: bl Check to see if '(' and ')' are balanced. Several behaviors are possible. If you execute 'bl' when the cursor is on a '(', bl will search forward from that point until it reaches either a balancing ')' or the end of the file. If it reaches a balancing ')', it will place the cursor there. If it reaches end-of-file without finding a balancing ')', it will leave the cursor in its original position and report an error stating that the delimiter is not balanced. If the cursor is on a ')', bl will search backward for the balancing '('. If you execute 'bl' when the cursor is not on a '(', bl searches backward for the nearest '(', and if one is found, a search is made foreward from that '('s position for a matching ')'. If a balance is found, the cursor is placed on the ')'. If no balance is found, the cursor is left in its original position and an error is reported stating that no matching delimiter is found. bl -d Do not limit the search to matching parentheses but search for any of the following delimiter pairs: ( ) parentheses [ ] square brackets { } curly brackets < > angle brackets (* *) Pascal comment delimiters begin end Pascal block delimiters /* */ C comment delimiters #ifdef #endif C conditional code delimiters do done shell for/while loop delimiters case esac shell case statement delimiters The same rules that apply to the bare form of 'bl' also apply to searches for any of the above delimiter pairs. If 'bl -d' is invoked and the cursor is on one of the above delimiters, that delimiter's counterpart is searched for. If the cursor is not initially on such a delimiter, bl will search backward for the nearest delimiter among the types shown above. bl <l> <r> Limit the search to the specified delimiters 'l' and 'r'. l and r can be any strings, except that they cannot be identical. Delimiters containing embedded blanks or pound signs must be enclosed in quotes. A convenient way to use this command is to define a key as 'bl -d' so that no matter what type of file you are editing, 'bl' will search for any of the above delimiters with a single keystroke. _______________________________________________________________________________ Copyright (c) 2005, Robert Styma Consulting. All rights reserved.