[asterisk-dev] XML documentation of apps/functions/the_rest_of_the_world

Tilghman Lesher tilghman at mail.jeffandtilghman.com
Tue Jul 8 12:22:53 CDT 2008

On Tuesday 08 July 2008 11:30:42 Michiel van Baak wrote:
> Hi all,
> Olle already mentioned it briefly, but I wanted to devote a whole post
> to it:
> We are currently working on defining and implementing an XML format for
> apps/function/etc documentation.
> The goal of this project is to convert the static documentation in the
> sourcecode into a parseable format that will be loaded at runtime.
> Right now, the apps for example, have a static char description that
> documents all the options etc. This info can only be used inside
> asterisk on the CLI with 'core show application FOO'

XML is fine for documentation, but I'd prefer to see it parsed at build time,
not at runtime.  There is no good reason to shift that parsing to runtime.


More information about the asterisk-dev mailing list