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.