Here there be dragons. Comments that explain what is already clear can clutter 
the code and make it harder to read. By all means document adequately, but 
don't simply echo the semantics of the code for the purported benefit of 
newbies. Even newbies can be distracted by unnecessary comments.

ObSyntaxRant There are languages where it is always possible to add a comment 
at the end of a statement; why does HLASM require a delimiter that is not 
always permissible? If it's the only way to add a comment, why should one of 
these be valid and the other not

     label    FOO   , comment
     label    BAR   , comment

where FOO has optional positional parameters and BAR has no positional 
parameters.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3

________________________________________
From: IBM Mainframe Assembler List [ASSEMBLER-LIST@LISTSERV.UGA.EDU] on behalf 
of Paul Gilmartin [00000014e0e4a59b-dmarc-requ...@listserv.uga.edu]
Sent: Friday, May 27, 2022 11:31 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: Generating a TR field

On May 26, 2022, at 16:26:38, Charles Mills wrote:
>
> And what is that? Some comments?
>
My thought, but what?:
A paraphrase of the OP's requirement?
And/or explanation of the unintuitive semantics of:
o "*" within a repetitive  constant definition?
o A character self-defining term used as a numeric value?
o "ORG" with *two* empty arguments?

But no fault to Ed.  His target was a level above your
putative "maintenance newbie" and valued brevity.

>> @Ed's approach is elegant, although a maintenance newbie might have
> trouble understanding what 256AL1(*-TABLE) did.
>>
> Troublesome only because Ed left out the most important thing.
>
>> -----Original Message-----
>> From: Ed Jaffe
>> Sent: Thursday, May 26, 2022 2:36 PM
>>
>> What you want should be trivial:
>> |TABLE DC  256AL1(*-TABLE)
>> |      ORG TABLE+C'*'
>> |      DC  CL1' '
>> |      ORG ,
>
> --
> gil

--
gil
Моё судно на воздушной подушке полно угрей.

Reply via email to