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

[Vadim Lebedev]

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


Thanks
Vadim
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.digium.com/pipermail/asterisk-dev/attachments/20081021/d8e11921/attachment.htm