× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.


  • Subject: Re: Right side comments
  • From: "Simon Coulter" <shc@xxxxxxxxxxxxxxxxx>
  • Date: Thu, 26 Jul 01 10:00:55 +1000

m
Hello Buck,

I wrote a utility many years ago to go through RPG III code and do exactly 
what you suggested -- mapping the END statement to the appropriate IF or DO 
clause.  It would build an end comment from the appropriate begin statement.  
For example;

B1   C           EXIT      DOUEQ$YES                       
B2   C           LSTCNT    IFGT *ZERO                      
B3   C           VIEW      IFEQ 1                          
X3   C                     ELSE                            
E3   C                     END                             VIEW = 1
X2   C                     ELSE                            
E2   C                     END                             LSTCNT > *ZERO
E1   C                     END                             EXIT U= $YES

(It also highlighted comments, flagged entry and exit points, underlined 
subroutine names, inserted the B1, X1, and E1 markers, changed END 
statements to the proper ENDIF, ENDDO, etc, flagged mismatched, extra, or 
missing END statements, and other stuff.)

For RPG III and even RPG/400 the comment area could be put to good 
use (but not for writing comments, 20 bytes is too small an area to do much 
other than reiterate the code -- although in extracting the above example I 
found some old code of mine where I had actually made what I consider 
exeptionally good use of the right-hand comments :).  As a friend of mine 
says:

        "Comments should illuminate, not reiterate"

With RPG IV there is no need at all for right-hand comments especially if 
the program is a new one.  It might be possible to argue a case for 
right-hand comments when converting from RPG III but I'm of the firm opinion 
that if you convert code to RPG IV then you should convert it properly 
rather than a half-baked RPG III style in RPG IV specifications.

Regards,
Simon Coulter.

«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»
«» FlyByNight Software         AS/400 Technical Specialists       «»
«» Eclipse the competition - run your business on an IBM AS/400.  «»
«»                                                                «»
«» Phone: +61 3 9419 0175   Mobile: +61 0411 091 400        /"\   «»
«» Fax:   +61 3 9419 0175   mailto: shc@flybynight.com.au   \ /   «»
«»                                                           X    «»
«»               ASCII Ribbon campaign against HTML E-Mail  / \   «»
«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»«»
+---
| This is the RPG/400 Mailing List!
| To submit a new message, send your mail to RPG400-L@midrange.com.
| To subscribe to this list send email to RPG400-L-SUB@midrange.com.
| To unsubscribe from this list send email to RPG400-L-UNSUB@midrange.com.
| Questions should be directed to the list owner/operator: david@midrange.com
+---

As an Amazon Associate we earn from qualifying purchases.

This thread ...

Follow-Ups:

Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2024 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.