sounds good.<br>I think we trust you enough to skip the review since it's just doxygen comments.<br><br><br><div class="gmail_quote">On Mon, Sep 21, 2009 at 12:02 PM, Muhammad Shahzad <span dir="ltr"><<a href="mailto:shaheryarkh@googlemail.com">shaheryarkh@googlemail.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;">Sure, i fully understand this role and its responsibilities. I will take special care for SVN commit process.<br>
<br>Anyways, here is a rough plan for the project. I hope this ensures code integrity at all levels.<br><br>1. Doxygen configuration files and directories setup.<br>
2. Then we will do header files documentation folder by folder, starting from inner most include directory (<FSROOT>/src/include/private) and then moving outwards.<br>3. Once one whole include folder is documented, we will first put it in our test environment and rebuild FS from scretch (i.e. after doing a distclean).<br>
4. One of my team member has promised me to provide a script that will run on each header file to produce a clean file (i.e. without any comments etc.). We will run it on both original (undocumented) and modified (documented) files and then do a diff on their output. If diff yeilds nothing then both documented and undocumented files are identical (code wise).<br>
5. When all files in a single folder pass this script test, I will commit it to SVN (alternatively i can forward them to you guys for review and then you can commit it to SVN).<br>6. Once all header files are done, we then do source code files repeating steps 3 - 5 for each folder in top most to inner most direction.<br>
<br>I haven't finalized resource allocation and time lines yet. However, the documentation will be mostly done by project members while i will do steps 3-5 personally.<br><br>Please review and give your feedback.<br>
<br>
Thank you.<div><div></div><div class="h5"><br><br><br><div class="gmail_quote">On Mon, Sep 21, 2009 at 10:05 PM, Anthony Minessale <span dir="ltr"><<a href="mailto:anthony.minessale@gmail.com" target="_blank">anthony.minessale@gmail.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;">
yah and since committing to header files will trigger a full core rebuild, limit it to one big patch at a time preferably at night.<br> <br><br><div class="gmail_quote"><div><div></div><div>On Mon, Sep 21, 2009 at 10:58 AM, Michael Jerris <span dir="ltr"><<a href="mailto:mike@jerris.com" target="_blank">mike@jerris.com</a>></span> wrote:<br>
</div></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div><div></div><div><div style="word-wrap: break-word;">The great thing about version control, if someone screws something up, we can always revert it. That being said, its just a matter of restraint. If your just doing docs, little harm can be caused. When you start committing actual code, typically even for those with commit access we review each others patches before we check them in to tree.<div>
<br></div><div>Mike</div><div><div></div><div><div><br><div><div>On Sep 21, 2009, at 11:19 AM, Muhammad Shahzad wrote:</div><br><blockquote type="cite">That would be great if you guys can have faith in me on this. :-)<br>
<br>Thank you.<br><br><br><div class="gmail_quote">On Mon, Sep 21, 2009 at 8:32 PM, Anthony Minessale <span dir="ltr"><<a href="mailto:anthony.minessale@gmail.com" target="_blank">anthony.minessale@gmail.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;">if you are careful we can give you svn commit so you can add it yourself.<div><div></div><div>
<br><br><br><div class="gmail_quote">On Sat, Sep 19, 2009 at 2:10 PM, Muhammad Shahzad <span dir="ltr"><<a href="mailto:shaheryarkh@googlemail.com" target="_blank">shaheryarkh@googlemail.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;">Hi,<br><br>While i am looking at things to be done and in which order, can you please define the process on how i will be submitting documentation to be added in FS Trunk?<br>
<br>Thank you.<div><div></div><div><br><br><br><div class="gmail_quote">
On Sat, Sep 19, 2009 at 10:00 PM, Muhammad Shahzad <span dir="ltr"><<a href="mailto:shaheryarkh@googlemail.com" target="_blank">shaheryarkh@googlemail.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;">
Thank you so much in giving me a chance to serve the FS community. Lets get things moving.<br><br>Unfortunately i missed conference call due to time zone confusion, silly me. Anywasy, i will make myself available for next weekly meetings.<br>
<br>If you guys would like to catch me on IRC, my nick is shaheryarkh.<br><br>If anyone wants to join me in documentation project, you can email at <a href="mailto:shaheryarkh@googlemail.com" target="_blank">shaheryarkh@googlemail.com</a>, so i can start distributing work amoung project participants.<br>
<br>Thank you.<div><div></div><div><br><br><br><div class="gmail_quote">On Sat, Sep 19, 2009 at 1:50 AM, Michael Collins <span dir="ltr"><<a href="mailto:msc@freeswitch.org" target="_blank">msc@freeswitch.org</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;">
FYI,<br><br>Muhammad Shahzad has officially been deputized for two things:<br>mod_dingaling maintainer<br>Doxygen master<br><br>:)<div><div></div><div><br><br><div class="gmail_quote">On Fri, Sep 18, 2009 at 7:24 AM, Raymond Chandler <span dir="ltr"><<a href="mailto:intralanman@freeswitch.org" target="_blank">intralanman@freeswitch.org</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;"><div style="word-wrap: break-word;"><div>Things like this might be good to talk about on our weekly conference call. It'll be starting in about 2 hours, maybe you should join the call and officially volunteer to start submitting patches to jira for the doxygen. We could even make a new section in JIRA for Doxygen under that "Project System" category.</div>
<div><br></div><div>-Ray</div><div><br></div><br><div><div><div>On Sep 18, 2009, at 3:18 AM, Muhammad Shahzad wrote:</div><br></div><blockquote type="cite"><div><div></div><div>Hi,<br><br>I have observed that one of the major hurdle while writing patches and / or bug fixes is lack of doxygen documentation for FS source code. For example it took me 5+ days to understand mod_dingaling code and its hooks into FS source code to write up soft reload patch, while it could have taken less then 3 days to do so if source code documentation was available.<br>
<br>So, since right now i have some human resources including myself available, I would like to document all source code (or at least core FS code i.e. everything that has "switch_" prefix) using doxygen. I know its a huge task and will take a while to complete but at least lets get it started.<br>
<br>If anyone else wants to participate as well in this task, then we can team up to complete it quickly.<br><br>Let me know if you guys are interested.<br><br>Thank you.<br clear="all"></div></div></blockquote></div></div>
</blockquote></div></div></div></blockquote></div></div></div></blockquote></div></div></div></blockquote></div><font color="#006312"><br></font></div></div>-- </blockquote></div></blockquote></div></div></div></div></div>
<br></div></div><div>_______________________________________________<br>
FreeSWITCH-dev mailing list<br>
<a href="mailto:FreeSWITCH-dev@lists.freeswitch.org" target="_blank">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></blockquote></div><div><div></div><div><br><br clear="all"><br>-- <br>Anthony Minessale II<br><br>FreeSWITCH <a href="http://www.freeswitch.org/" target="_blank">http://www.freeswitch.org/</a><br>ClueCon <a href="http://www.cluecon.com/" target="_blank">http://www.cluecon.com/</a><br>
Twitter: <a href="http://twitter.com/FreeSWITCH_wire" target="_blank">http://twitter.com/FreeSWITCH_wire</a><br><br>AIM: anthm<br><a href="mailto:MSN%3Aanthony_minessale@hotmail.com" target="_blank">MSN:anthony_minessale@hotmail.com</a><br>
GTALK/JABBER/<a href="mailto:PAYPAL%3Aanthony.minessale@gmail.com" target="_blank">PAYPAL:anthony.minessale@gmail.com</a><br>
IRC: <a href="http://irc.freenode.net" target="_blank">irc.freenode.net</a> #freeswitch<br><br>FreeSWITCH Developer Conference<br><a href="mailto:sip%3A888@conference.freeswitch.org" target="_blank">sip:888@conference.freeswitch.org</a><br>
<a href="http://iax:guest@conference.freeswitch.org/888" target="_blank">iax:guest@conference.freeswitch.org/888</a><br>
<a href="mailto:googletalk%3Aconf%2B888@conference.freeswitch.org" target="_blank">googletalk:conf+888@conference.freeswitch.org</a><br>pstn:213-799-1400<br>
</div></div><br>_______________________________________________<br>
FreeSWITCH-dev mailing list<br>
<a href="mailto:FreeSWITCH-dev@lists.freeswitch.org" target="_blank">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></blockquote></div><br><br clear="all"><br>-- <br></div></div><div><div></div><div class="h5">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" target="_blank">shari_786pk@hotmail.com</a><br>Email: <a href="mailto:shaheryarkh@googlemail.com" target="_blank">shaheryarkh@googlemail.com</a><br>
</div></div><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></blockquote></div><br><br clear="all"><br>-- <br>Anthony Minessale II<br><br>FreeSWITCH <a href="http://www.freeswitch.org/">http://www.freeswitch.org/</a><br>ClueCon <a href="http://www.cluecon.com/">http://www.cluecon.com/</a><br>
Twitter: <a href="http://twitter.com/FreeSWITCH_wire">http://twitter.com/FreeSWITCH_wire</a><br><br>AIM: anthm<br><a href="mailto:MSN%3Aanthony_minessale@hotmail.com">MSN:anthony_minessale@hotmail.com</a><br>GTALK/JABBER/<a href="mailto:PAYPAL%3Aanthony.minessale@gmail.com">PAYPAL:anthony.minessale@gmail.com</a><br>
IRC: <a href="http://irc.freenode.net">irc.freenode.net</a> #freeswitch<br><br>FreeSWITCH Developer Conference<br><a href="mailto:sip%3A888@conference.freeswitch.org">sip:888@conference.freeswitch.org</a><br><a href="http://iax:guest@conference.freeswitch.org/888">iax:guest@conference.freeswitch.org/888</a><br>
<a href="mailto:googletalk%3Aconf%2B888@conference.freeswitch.org">googletalk:conf+888@conference.freeswitch.org</a><br>pstn:213-799-1400<br>