RE: Reusable module repository -- RPG400-L

Check this out:
http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/javadoc.html

I am interested in looking in to how doxygen produces documentation 
automatically from undocumented code.  This would probably be a nice 
feature to include.


rpg400-l-bounces@xxxxxxxxxxxx wrote on 07/07/2006 08:42:14 AM:

I have "started" on some of the backbone for this.  I haven't posted any
code or anything yet but I'll post an update when I have something to
actually show...I'm using the term "ILEDocs" since not all modules will
be RPG....

Hopefully I can get some time today to work more on this.  Biggest issue
I have is not knowing what all javadocs contains etc. but I'm sure I can
google up some info...


Thanks,
Tommy Holden


-----Original Message-----
From: rpg400-l-bounces@xxxxxxxxxxxx
[mailto:rpg400-l-bounces@xxxxxxxxxxxx] On Behalf Of
AGlauser@xxxxxxxxxxxx
Sent: Friday, July 07, 2006 7:35 AM
To: RPG programming on the AS400 / iSeries
Subject: Re: Reusable module repository

Thanks Rory.  I was thinking about something along these lines - only 
combined with the Wiki idea.  My thought was to run a processor over the

source and then update a Wiki with the results automatically.  I really 
like the idea of making the setup so automatic, so that the programmer 
doesn't have yet another extra step in the compilation process.

Another automation thought was to write an LPEX extension similar to
RSE's 
'New Procedure Wizard', which would be a bit more flexible in terms of 
allowing for different style preferences, as well as producing
'ILEdocs', 
or whatever it will be called.

Looking forward to the article!
Adam

rpg400-l-bounces@xxxxxxxxxxxx wrote on 06/07/2006 10:25:14 PM:

Adam,

I use a compile preprocessor exit program which automatically runs

things

like DSPPGMREF over any program or module when it is compiled. It also


uses

the QBNLMODI/QBNLPGMI API's to update a central file with details of

all 
the

exported procedures and their descriptive text (it even flags an error

and

won't compile the module if the developer hasn't added descriptive

comments

for each exported procedure!). Sort of like Scott's Wiki, but more
green-screen-ish :)

Best of all, because it's part of our compilation process, there's no

extra

step required - every time anything is compiled, the xref database is
updated.

I have an article in a forthcoming issue of iSeries Network News

(August, I

think), which shows the code for our compile preprocessor with an

example

exit program, which you could use as a template for something like

this.


Rory
-- 
This is the RPG programming on the AS400 / iSeries (RPG400-L) mailing

list

To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/rpg400-l.


########################################################################
#############
Attention:
The above message and/or attachment(s) is private and confidential and
is intended 
only for the people for which it is addressed. If you are not named in
the address 
fields, ignore the contents and delete all the material. Thank you. Have
a nice day.

For more information on email virus scanning, security and content
management, please contact administrator@xxxxxxxxxxxx
########################################################################
#############
-- 
This is the RPG programming on the AS400 / iSeries (RPG400-L) mailing
list
To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/rpg400-l.


-- 
This is the RPG programming on the AS400 / iSeries (RPG400-L) mailing

list

To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/rpg400-l.


#####################################################################################
Attention:
The above message and/or attachment(s) is private and confidential and is 
intended 
only for the people for which it is addressed. If you are not named in the 
address 
fields, ignore the contents and delete all the material. Thank you. Have a nice 
day.

For more information on email virus scanning, security and content
management, please contact administrator@xxxxxxxxxxxx
#####################################################################################