> On 2020-04-30, at 10:17:03, Phil Smith III wrote:
>
> Seymour J Metz wrote:
>
>> I can already figure out that the instruction will be executed; tell me
>> *why* in the comment. How does it fit in the broader scheme of things?
>> Where are the EX instructions and what is the significance of the
>> lengths that they use?
>
I was quite frustrated when I had to modify some
well-parameterized but adversely commented code
(actually FOSS output from PL/S) which resembled:
NROWS DC H'16'
where I wanted to change NROWS, but I stumbled onto:
MH R2,NROWS Multiply by 16
Grrr. The code was parameterized, the comment wasn't.
-- gil