Hm, not a bad point, Andrew.  I should maybe keep it in mind when I write for 
others, or when something I write for myself may eventually get into the public 
domain.

---
Bob Bridges, [email protected], cell 336 382-7313

/* Why don't our civics courses teach pupils what the word "usurped" means?  Is 
this a concept that government thinks we can do without?  -Joseph Sobran */

-----Original Message-----
From: IBM Mainframe Discussion List <[email protected]> On Behalf Of 
Andrew Rowley
Sent: Tuesday, September 28, 2021 21:07

I guess the first looks like a statement with a purpose, the second looks like 
a comment that can be freely edited e.g.

/* This program converts...

Things may not be as obvious to newcomers as they are to those with more 
experience.

--- On 29/09/2021 6:54 am, Bob Bridges wrote:
> Purely by the way, but I've never really understood why so many REXX modules 
> I see start like this:
>
>    /* REXX */
>    /* Module: Name
>       Author: Bob Bridges the Magnificent
>       Purpose: Convert ANSI dates to internal format, or whatever. */
>
> ...instead of something like this:
>
>    /* This REXX converts ANSI dates to internal format, or whatever. */
>    /* Module: Name
>       Author: Bob Bridges the Magnificent */

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: INFO IBM-MAIN

Reply via email to