[asterisk-dev] Asterisk XML documentation (appdocsxml branch) is ready

Vadim Lebedev 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...
URL: http://lists.digium.com/pipermail/asterisk-dev/attachments/20081021/d8e11921/attachment.htm 

More information about the asterisk-dev mailing list