As I see it the important comments are those that explain WHY it is coded
as it is.
The only times I really wanted comments when there were none is when I
wanted to know the reason for the coding at all or why it was coded in just
that way.
(E g when I was putting in changes in programs I didn't created and the
programmer was not availible (changed job, retired or dead.))
Thomas Berg

Den sön 12 jan. 2025 22:32Seymour J Metz <sme...@gmu.edu> skrev:

> When I was drafted into teaching a programming class I warned my student
> that I would take points off for pointless comments.
>
> However, the putting the source code into the object code as comments in
> the PL/S output does serve a purpose. Or are you referrin to /* ... */
> comment in the PL/S source code?
>
> --
> Shmuel (Seymour J.) Metz
> http://mason.gmu.edu/~smetz3
> עַם יִשְׂרָאֵל חַי
> נֵ֣צַח יִשְׂרָאֵ֔ל לֹ֥א יְשַׁקֵּ֖ר
>
>
>
> ________________________________________
> From: IBM Mainframe Discussion List <IBM-MAIN@LISTSERV.UA.EDU> on behalf
> of Paul Gilmartin <0000042bfe9c879d-dmarc-requ...@listserv.ua.edu>
> Sent: Sunday, January 12, 2025 3:31 PM
> To: IBM-MAIN@LISTSERV.UA.EDU
> Subject: Re: The mainfeame is alive
>
> External Message: Use Caution
>
>
> On Sun, 12 Jan 2025 14:56:57 +0000, Seymour J Metz wrote:
>
> >You don't usually see a comment on every line. In a well constructed
> program you only see comments where they add values, e.g., readability,
> maintainability, change tracking.
> >
> I saw a PL/S listing on fiche.  Every source line bore a comment.
> I surmised it was a coding standard, perhaps enforced mechanically.
> And those comments likewise, might as well have been generated
> mechanically.
>
> I could write a macro to do that.
>
> --
> gil
>
> ----------------------------------------------------------------------
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>
>
> ----------------------------------------------------------------------
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Reply via email to