[asterisk-dev] Command Syntax -- weird?

[Tzafrir Cohen]

On Sat, Apr 22, 2006 at 02:35:21PM -0400, Peter Beckman wrote:

> 
>  I completely agree.  The problem is that the documentation for Asterisk is
>  extremely fragmented and inconsistent.  My goal with the documentation
>  above is twofold -- a unified, single source of documentation for Asterisk
>  (not a wiki, which is fine, but again, several voices and several formats
>  and inconsistent documentation updating means confusion and unprofessional
>  face), and a method of writing documentation that extends itself for
>  translation and fast updating.
> 
>  Right now, there is the wiki on voip-info, there are several other sites
>  that attempt to document AGI calls, there is the asteriskdocs.org book,
>  but no definitive function reference.  In fact, I've read posts from users
>  who say they can't figure out what the function call should do in which
>  version!
> 
>  I think Asterisk is a great tool, and very powerful, but without good,
>  solid, accurate and up-to-date online web-based documentation, it is a
>  tool for the tinkerer, not the masses.

http://www.asterisk.org/doxygen/ is the documentation that is generated
from the code of Asterisk . If you want your documentation to be
maintained with the evolution of the code, it has to be there (in the
doxygen docs, that is).

-- 
Tzafrir Cohen      sip:tzafrir at local.xorcom.com
icq#16849755       iax:tzafrir at local.xorcom.com
+972-50-7952406           
tzafrir.cohen at xorcom.com  http://www.xorcom.com