Re: javadoc for RPGLE

Well JSDOC 3 is a node.js project so it should be able to run on IBM I.

JSDOC is made to document javascript modules that is very similar to a
RPGLE service program.

JSDOC generates a number of HTML documents based on a single JS module, it
can do the same
to a RPGLE service program with very few changes.

In javascript is is very easy to manipulate/generate RPGLE code so why all
this work around?

On Tue, Aug 29, 2017 at 6:22 PM, Jon Paris <jon.paris@xxxxxxxxxxxxxx> wrote:

I know that Paul Tuohy's RPGLEDOC 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 Paris

www.partner400.com
www.SystemiDeveloper.com

On Aug 29, 2017, at 12:16 PM, John Yeung <gallium.arsenide@xxxxxxxxx>

wrote:

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.
--
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: 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.

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

--
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: 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.

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