RE: Documentation tools

["Andre Carregal" <carregal@...>]

> Talking about this unfortunate JavaDoc style, perhaps you
> might want to consider an, er, "alternative" format:

By "unfortunate JavaDoc style" you are referring to the in-source syntax of
JavaDoc or the its generated HTML pages?

LuaDoc has a back end processor that extracts information from the source
files, and a front end processor that generates a "static site" from the
extracted information.

Once you have the information structured in memory, you could generate lots
of different "sites" from it. You could also generate PDF docs for example.

I couldn't find an example of DyDoc syntax (I'm assuming it is also
in-source based), but as far as I can see, a good templating scheme should
handle that formatting without much hassle.

Could you please elaborate a bit?

Thanks,

Andre Carregal