RE: Line-by-line commenting in source code

> Mark Walter
>Here, there are comments like 
>'Display Prompt' right before the statement
>EXFMT Prompt. If you don't know that EXFMT 
>Prompt is going to be displaying a prompt 
>screen, you have no business editing the code.

Over 10 years ago some coworkers were discussing the uselessness of much of
the "documentation" within programs' inline comments.  In code review
programmers would be told, "OK, the program works, but you have to go back
and add comments."  So the programmer would go back and note the obvious in
C* lines or the right hand column of Calc specs.

Ever since that conversation I've taken to adding the following block to end
each RPG program:

 *
 *         set INLR indicator on                                 
 *
C                     MOVE *ON       *INLR            set INLR on


And in CL:

ENDPGM:     ENDPGM     /* ENDPGM */ 


-Jim