AW: Reusable module repository

hi,

i think this is a common problem in the rpg world. i think almost every other 
language has somehow covered this topic, only rpg hasn't.

doxygen (http://www.stack.nl/~dimitri/doxygen/) is a nice project that can be 
used as a general documentation tool for inline documentation (docu in the 
sourcecode). though it can't be used for rpg the concept can be copied quite 
easily. we are currently developing such a tool and it works quite well for 
program and procedure documentation.

a documentation block starts with /** (which is ok for the rpg compiler) and 
ends with */ (which also works for the rpg compiler). define some tags and 
parse them.

we are currently using velocity (http://jakarta.apache.org/velocity/) to create 
some html files with the parsed info on the ifs. these files are put in the 
document directory of on apache server instance, so we always have the 
documenation up to date.

if someone is creating an open source project for it, i'm ready for joining it. 
=) 

-----Ursprüngliche Nachricht-----
Von: rpg400-l-bounces@xxxxxxxxxxxx [mailto:rpg400-l-bounces@xxxxxxxxxxxx] Im 
Auftrag von AGlauser@xxxxxxxxxxxx
Gesendet: Donnerstag, 6. Juli 2006 20:27
An: RPG programming on the AS400 / iSeries
Betreff: Reusable module repository

Hi all,

I hope this is considered on-topic, seeing as how it is a programming 
related problem.  Just wondering if anyone has any recommendations for a 
system to track and document modules and service programs which are 
intended to be reused internally.  I've poked around Sourceforge a bit and 
I'm having trouble finding anything of this ilk.  I'm not even sure 
exactly what we would need to track, but the sort of thing that comes to 
mind are name, description, files used, documentation for each procedure 
(perhaps through some sort of Javadoc type system, but for RPG), 
references to some programs that use the module (for usage example 
purposes), etc.  Another key feature would be a good search function - I 
can't reuse something if I can't find it.

Does this sort of thing exist?  Any suggestions would be appreciated,
Adam
#####################################################################################
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
#####################################################################################