RE: Procedure Management Procedures

[James Rich <james@xxxxxxxxxxx>]

On Wed, 29 Aug 2001, Smith, Nelson wrote:

> So, you're saying you just follow the same format as unix uses to document
> it's commands, but for your homegrown procedures, you create them manually?
> If that's the case, can you then use a unix utility to display them?

Answered in a previous email.

> I've long looked for some way to easily display info about our procedures to
> the other inhouse programmers, but haven't found any good way. I create
> (manually) a format similiar to what you are showing, but I have no where to
> put it except in the copy member I use for the prototypes.  I would love to
> see some sort of utility that would display them graphically in a tree
> structure based on category or useage or something of that sort.  Anyone
> know of any thing like that?

What we've done is to put all our docs online in html, categorically
organized similar to linux HOWTOs (I wonder if our documentation writer
uses linux a lot? :) ).

I seems to me that what you are looking for is something like DocBook (I
think) that generates documentation from source code.  I suppose you could
save your source files in the IFS (but I don't know how), mount the
filesystem on your win/linux/sun/whatever box, and teach (or write) your
favorite documentation generating program about RPG.  I think this would
be easier than writing such a program in RPG but I could be wrong.

James Rich
james@eaerich.com