greetings seekers (& those only pretending to be seekers :-)
i raised the issue, and now that i have been given
an answer, it seemed only right to leave it here as part of
this thread, in hopes of helping any who follow.
first, i must confess that my poorly constructed
sample actually works just fine, but the illustrated
problem recurred with a better contrived example.
i visited the p::rd mailing list
(mailto:recdescent@perl.org), laid out the
problem and, "hey presto!", i was enlightened, thusly:
SHORT ANSWER:
always place a blank line after every usage of the '<<'
shift operator, but do it INSIDE the action.
{
$main::Instruction_lower = 0x000000
| (($item[16] & 0x000003) << 10)
;# the next blank line is required.
1;
}
the LONG ANSWER (without permission, but with many
thanks) is:
"the problem is with Text::Balanced::_match_quotelike
where it thinks the '<<' is a hereis operator instead of a
shift and tries to process it like a quoting operator.
. . .
The reason for the bug is that it consumes the entire
input and the parser fails in a bizarre way that makes it
think everything after the '<<' is part of that hereis
literal.
So to fake it out, give it what it wants, which is a
blank line after every usage of the '<<' shift operator,
but you have to do it INSIDE the action. The original code
had the blank line after the action and the parser parser
looses its mind."
many thanks to all that helped and/or tried.