[asterisk-dev] Asterisk XML documentation (appdocsxml branch) is ready
vadim at mbdsys.com
Tue Oct 21 05:22:35 CDT 2008
Russell Bryant wrote:
> Tilghman Lesher wrote:
>> On Sunday 19 October 2008 19:59:08 Vadim Lebedev wrote:
>>> Maybe it's a dumb idea but I wonder,
>>> if the same effect could be achieved by keeping Doxygen format doc and
>>> using some XSLT processing
>>> to transform whatever need to transformed to XML.
>> Someone can correct me if I'm wrong, but I believe that the appdocsxml branch
>> isn't meant to replace developer documentation at all, which will stay as
>> Doxygen format, but rather to fixup the user-embedded documentation, such that
>> multiple translations can coexist in the code.
> Correct. In addition to translations, having it in a parseable format
> will make it easier to take the same information and use it outside of
> the code for the purpose of having higher quality, maintainable
> user-oriented documentation.
Still it seems, that the desired effect can be achieved by using
doxygen and post processing resulting HTML with XSLT to extract
user-level doc only
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the asterisk-dev