Review Board 1.7.16


Implement parsing of AGI XML documentation

Review Request #50 - Created Nov. 11, 2008 and submitted

Eliel SardaƱons
Reviewers
asterisk-dev
Asterisk
This is the implementation needed to parse the AGI XML documentation, the syntax generator was made with the idea of used it to parse the CLI syntax in the near future.

 
Ship it!
Posted (Nov. 11, 2008, 12:02 p.m.)
Assuming it's tested (since that part wasn't filled in in the review request ;-) ), then it's good to go with these minor comments.
/trunk/include/asterisk/agi.h (Diff revision 1)
 
 
 
For what it's worth, I very much prefer the other style of doxygen documentation (not on the same line).

My reasoning is that I think that having the docs on the same line encourages people to write very short, and often useless documentation.  It's much easier to write useful documentation that can span multiple lines when you put it before the var you are documenting.
/trunk/main/xmldoc.c (Diff revision 1)
 
 
 
if (!enumname) continue;  ;-)

https://reviewboard.asterisk.org/ runs on a server provided by Digium, Inc. and uses bandwidth donated to the open source Asterisk community by API Digital Communications in Huntsville, AL USA.
Please report problems with this site to asteriskteam@digium.com.