Re: javadoc for RPGLE

On Tue, Aug 29, 2017 at 1:42 PM, Charles Wilt <charles.wilt@xxxxxxxxx> wrote:

"missing" as in any other options I didn't already having listed.

Actually, I think Jon was talking about what was missing from the
options already listed. The relevant quotes from the thread:

Charles:

It seems Mihael's newer ILEDOCS is the only one currently
maintained, but from what I can tell, it doesn't yet have the
RPGLE parsers included.

John:

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?

Jon:

I know that Paul Tuohy's RPGLEDOC [which was one of the
ones Charles listed originally] handles RPG IV. Not sure if it
has been adapted to accept free-form yet but it most certainly
handles RPGLE. Heck the product name would be particularly
silly if it didn't!

Perhaps the OP could quantify what "missing" meant in this
context.

Jon is asking how Paul Tuohy's RPGLEDOC falls short of your requirements.

I was basically asking the same thing, but with less knowledge of any
of the tools. Jon evidently has at least some familiarity with one of
them.

But I think this part of your response answers that:

I don't think any of the existing tools have been extended to free form
declarations or fully free.

So finally, we are left with:

no problem, they are open source I could add them. But I'm wondering if
there's any advantage to extending a non-RPG specific tool instead.

I would imagine it's much easier and more effective to modify one of
the existing RPG tools, particularly if you need it to run on the i.

I only went down the non-RPG rabbit hole because I thought for some
reason you had eliminated the existing RPG tools.

Now, if you happen to strongly prefer the generated output of Sphinx
(I believe this is one reason some folks use it to document languages
other than Python), it should be *comparatively* easy to adapt the
output of one of the RPG tools to a form usable by Sphinx (possibly
making use of AutoAPI). And this should run fine in PASE with either
of IBM's Pythons.

John Y.