The primary objective of this documentation is to give full view of FS and its module regardless of programming language, as at many places especially in the language modules, source code files from different programming languages fit together with each other like a jigsaw puzzle to complete the picture (i.e. module functionality). Breaking the directory hierarchy on programming language basis would not give the actual composition of module, thus confusing the developers who wants to write up new language modules.<br>
<br>We are documenting everything that is inside <FSROOT>/src folder plus 4 directories in <FSROOT>/libs folder, which are maintained by FS developer community, these are,<br><br>libdingaling<br>libteletone<br>
openzap<br>esl<br><br>So, i think i am covering entire code base. If you think i am missing something, kindly send me relative path with respect to FSROOT, for example,<br><br><FSROOT>/libs/libdingaling<br><br>Thank you.<br>
<br><br><div class="gmail_quote">On Tue, Sep 29, 2009 at 11:33 PM, Yossi Neiman <span dir="ltr"><<a href="mailto:freeswitch@cartissolutions.com">freeswitch@cartissolutions.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Muhammad,<br>
<br>
I and many others appreciate the work you are doing on the API docs. I<br>
did want to make a request, based upon what I've been seeing on the<br>
<a href="http://docs.freeswitch.org" target="_blank">docs.freeswitch.org</a> pages recently. Would it be possible to split out<br>
the documentation based upon language involved? My eyes are getting<br>
cluttered with swig and C++ docs mixed in with the C docs, and it's<br>
making it a little difficult for me to find what I am looking for. I<br>
can see this helping other folks as well, since I think that others<br>
would also want to see only docs pertaining to the language that they<br>
are currently working in.<br>
<br>
I also have the feeling that some/many of the functions that were<br>
previously listed under the Modules->Core Library. For example, we're<br>
missing a whole bunch of functions that were previously shown under the<br>
IVR Library and IVR Menu Library.<br>
<br>
Thanks,<br>
<br>
--<br>
Yossi Neiman<br>
Cartis Solutions, Inc.<br>
<a href="http://www.cartissolutions.com" target="_blank">http://www.cartissolutions.com</a><br>
<div><div></div><div class="h5"><br>
<br>
<br>
Muhammad Shahzad wrote:<br>
> Hi,<br>
><br>
> Please see attached herewith doxygen configuration file for FS<br>
> documentation. this should replace the one found at<br>
> <FSROOT>/docs/Doxygen.conf.<br>
><br>
> It has following additional features,<br>
><br>
> 1. Search Engine support, with which you can search any identifier<br>
> within entire documentation tree.<br>
> 2. Various graphs and diagrams to illustrate position and importance<br>
> of each file and how all files within a library fit together to<br>
> provide specific functionality.<br>
> 3. Name Space list, along with complete alphabetical index of all<br>
> methods in them.<br>
> 4. Documentation coverage for all FreeSWITCH modules (previously it<br>
> only generates documentation for application modules).<br>
> 5. Documentation for all libraries maintained by FS developers (ESL,<br>
> Dingaling, Teletone and Openzap).<br>
> 6. Todo list.<br>
> 7. Links to access fully formated source code of each file with line<br>
> numbers and syntax highlighting etc.<br>
> 8. Identifier cross reference list, i.e. a list of all methods and<br>
> variable who call a given method or variable.<br>
> 9. UML style inheritance and collaboration diagrams.<br>
> 10. Configuration for LATEX, RTF and Microsoft CHM formats also<br>
> available but not enabled. Any developer who wish to have<br>
> documentation in any of these format may find and enable one or more<br>
> of these formats as per his/her requirements.<br>
><br>
> Please review and add it to FS trunk.<br>
><br>
> All comments and suggestions are welcome.<br>
><br>
> Thank you.<br>
><br>
><br>
> --<br>
> Muhammad Shahzad<br>
> -----------------------------------<br>
> CISCO Rich Media Communication Specialist (CRMCS)<br>
> CISCO Certified Network Associate (CCNA)<br>
> Cell: +92 334 422 40 88<br>
</div></div>> MSN: <a href="mailto:shari_786pk@hotmail.com">shari_786pk@hotmail.com</a> <mailto:<a href="mailto:shari_786pk@hotmail.com">shari_786pk@hotmail.com</a>><br>
> Email: <a href="mailto:shaheryarkh@googlemail.com">shaheryarkh@googlemail.com</a> <mailto:<a href="mailto:shaheryarkh@googlemail.com">shaheryarkh@googlemail.com</a>><br>
<div class="im">> ------------------------------------------------------------------------<br>
><br>
> _______________________________________________<br>
> FreeSWITCH-dev mailing list<br>
> <a href="mailto:FreeSWITCH-dev@lists.freeswitch.org">FreeSWITCH-dev@lists.freeswitch.org</a><br>
> <a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev</a><br>
> UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-dev</a><br>
> <a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<br>
</div><font color="#888888">--<br>
Yossi Neiman<br>
President<br>
Cartis Solutions, Inc.<br>
P) 630-259-8100<br>
<a href="http://www.cartissolutions.com" target="_blank">http://www.cartissolutions.com</a><br>
</font><div><div></div><div class="h5"><br>
<br>
_______________________________________________<br>
FreeSWITCH-dev mailing list<br>
<a href="mailto:FreeSWITCH-dev@lists.freeswitch.org">FreeSWITCH-dev@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-dev" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-dev</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br>________________________________________________________<br>| |<br>
| FATAL ERROR --- O X |<br>|_______________________________________________________|<br>| You have moved the mouse. |<br>
| Windows must be restarted for the changes to take effect. |<br>| <OK> |<br>####################################/<br><br><br>Muhammad Shahzad<br>
-----------------------------------<br>CISCO Rich Media Communication Specialist (CRMCS)<br>CISCO Certified Network Associate (CCNA)<br>Cell: +92 334 422 40 88<br>MSN: <a href="mailto:shari_786pk@hotmail.com">shari_786pk@hotmail.com</a><br>
Email: <a href="mailto:shaheryarkh@googlemail.com">shaheryarkh@googlemail.com</a><br>