× 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: javadoc style comments and processing
  • From: "DeLong, Eric" <EDeLong@xxxxxxxxxxxxxxx>
  • Date: Tue, 3 Apr 2001 09:04:58 -0500

Tony, 

Sounds interesting, but I think for this to be truly useful, you (or
someone) may also need to code a user defined function (exit point
procedure) for SEU so we can insert your command templates. I played around
with one of the examples in the SEU manual (split/unsplit) and it was a real
mess. I never got any consistent results (the code lifted from the manuals
had some bugs), and haven't been back. It should be doable, though. 

Eric

-----Original Message-----
From: Tony Goodwin [mailto:tony.goodwin@dact.demon.co.uk]
Sent: Monday, April 02, 2001 3:55 PM
To: RPG400-L (E-mail)
Subject: javadoc style comments and processing



I noted some time back that someone wondered if there was
a tool to extract the interface from a service program to
produce javadoc style documentation.

I saw no replies (other than barbara's whos the best person to add it to
the RPG compiler!!)

Anyway I am not promising same, but have come to problem
from another direction. I have created two tools to save
development and documentation time.

No 1. Adds comments to service programs in structured fashion
in essence to create a standard template. The tool creates
something like the following, from the original source
(the function declaration) to create the @params and @returns
etc.

/**--------------------------------------------------------
 * XXXXX Add DESCRIPTION HERE
 * @author XXXXXX
 * @version X.X
 * @param Lib
 * @param File
 * @param Mbr
 * @param Field
 * @param RRN
 * @returns XXXX add RETURN DESC HERE
 *-------------------------------------------------------*/
  *--------------------------------------------------------
 p AHI_display     b                   Export
  *--------------------------------------------------------
 D AHI_display     PI             1S
 D  Lib                          10A   Options(*Omit)
 D  File                         10A   Value
 D  Mbr                          10A   Options(*Omit)
 D  Field                        10A   Value
 D  RRN                          10P 0 Value

No 2 tool, takes the new service program source and parses
for javadoc style comments /** .... */ and creates HTML
source giving (a) summary list of functions in module and
references to detailed comment (the above bit)

Anyway after all that, I want to know if anyone would like
a handle on source for this. Its not in java (ILE RPG) -
I toyed with the javadoc code for the parsing, but decided
with licensing etc - wasn't worth the effort

I can either post here (dont think thats a good idea) or
I'll answer each privately, or post someplace common if they
will take it!! (dont we all get paranoid about our code
in case someone else doesn't like your style ?)

Tony


-------------------------------------------
Tony Goodwin
Dact Ltd.
07775 918903
mailto:tony.goodwin@dacttechnologies.com

+---
| 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
+---

+---
| 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 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.