Re: javadoc for RPGLE

On Tue, Aug 29, 2017 at 9:03 AM, Charles Wilt <charles.wilt@xxxxxxxxx> wrote:

Started out looking at Doxygen

Was this one of the "existing non-RPG tool[s]" you had in mind? Did
you immediately rule it out for being written in C++?

Yes and no, since I could in theory port the code to the i.

I hear you.

Were the old RPG ones (and Mihael's newer one) too limited in
features? You mentioned that RPGLE parsing was missing. Would any of
them nevertheless still work better than a comment-reader-only doc
generation system?

Everything I could find in Sphinx documentation leads me to believe it
only works on reStructuredText.

The exception being the Autodoc tooling...but it's just for Python.

Well, there's also the AutoAPI project, but from what I can tell it's
kind of like Breathe in that it's expecting the source language to
already have been "serialized".

Even with only the reST support, you *could* do something vaguely like
Henrik's approach.

And unless all parts of this process absolutely positively must run on
the i, I think I would at least take a serious look at an IFS share or
mirror to give myself access to a broader selection of software (such
as Natural Docs).

John Y.