Re: Auto-building docs manual

There are already several tools out there already that can do this (and more) based on the Java Docs type comment definitions.

You can find Paul Tuohy's offering RPGLEDOC here: http://systemideveloper.com/downloadRPGLEDOC.html <http://systemideveloper.com/downloadRPGLEDOC.html> - I think it needs some updates but the base is there.

Others will no doubt point you at other offerings but I don't have time to look them up right now.

In summary - there are many things I'd rather have IBM spend their time and money on rather than reinventing this particular wheel.


Jon Paris

www.partner400.com
www.SystemiDeveloper.com

On Feb 22, 2018, at 11:11 AM, Booth Martin <booth@xxxxxxxxxxxx> wrote:

This has been nibbling on me for a while. It seems reasonable to me but what do I know.

Lets say that IBM provided a new kind of comment line designed to be automatically collected at every compile and then included in a IFS repository as a manual for that application/library/department/whatever. Therefore there would be an automatically assembled Intranet website for the system.

For example, say, a line which looked like:

//:index':'comment*/

Then we could specify particular comments to be used that could document, with a built-in index, our own procedures, programs, etc that are gathered in one useful place.

--
This is the RPG programming on the IBM i (AS/400 and iSeries) (RPG400-L) mailing list
To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: https://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at https://archive.midrange.com/rpg400-l.

Please contact support@xxxxxxxxxxxx for any subscription related questions.

Help support midrange.com by shopping at amazon.com with our affiliate link: http://amzn.to/2dEadiD