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