Re: IDL Documentation tool?

[Paul van Delst <pvandelst(at)ncep.noaa.gov>]

Daniel Luebbert wrote:
> 
> Hi there,
> 
> I am trying to generate a documentation for a large bunch of IDL
> programs of mine,
> so that someone else could easily understand and use them.
> Does anyone know of a program, PERL script, commercial tool or whatever
> else
> which could generate a complete documentation from the source code?

Uhhh... don't you write the documentation *before* the code?

At first I thought MK_HTML_HELP would do the job, but you want something to actually go in and parse
the source code and hunt about for all the dependencies along with argument lists?

Jeez.

You'd still have to modify all the routine documentation so that other users know, say, what units
the various arguments are supposed to be in. Wot a job.

It sounds like a good project in which to learn Perl.... :o)  Hmmm....

Good luck.

paulv
-- 
Paul van Delst                 A little learning is a dangerous thing;
CIMSS @ NOAA/NCEP              Drink deep, or taste not the Pierian spring;
Ph:    (301) 763-8000 x7274    There shallow draughts intoxicate the brain,
Fax:   (301) 763-8545          And drinking largely sobers us again.
Email: pvandelst@ncep.noaa.gov                    Alexander Pope.