[Freeswitch-dev] Doxygen help
I am not sure how many folks make use of the Doxygen documentation. I know I do all the time. I find that it provides a nice conceptual view of FreeSWITCH's API, which can make it very easy to find the functions and data types needed for writing modules for FreeSWITCH. A person by the name of Mohammad Shahzad (apologies if I misspelled it) started to do a lot of work on revamping the Doxygen configuration for FreeSWITCH a few months back. The problem with the work that he did was that he used Doxygen 1.6.x specific configuration parameters that are not understood by the Doxygen 1.4.x tree (which is what we currently use in FreeSWITCH) or even the 1.5.x tree which is what is in Slackware. In my discussions with Michael Collins we have decided that it might not hurt to go ahead and move the Doxygen version forward to match the 1.6.x tree. We are looking for somebody who has interest in working with the Doxygen configuration to continue the work that Mohammad had started and to help the project out. If you are such a person, please contact me off-list and I can provide further information. Thanks! Yossi Neiman
Hi, Its a quite embarrassing to admit that i could completed that work, not even able to submit what was done to FS trunk due to my own stupidity. Actually, we are having major power crisis in the country for last 1 years and most of power cuts are so long that even best UPS systems can't ensure 24/7 up time for our servers. About 3 months ago the development server i was working on for FS Docs was hit by this problem and its hard disk crashed, destroying all my hard work on FS Docs and mod_msn. It was my mistake that i didn't arrange for proper backup for my work due to shortage of resources and didn't inform the FS developers community about the loss. I want to restart this work but don't want to take the lead on this due to issues described above. If you can arrange a common server for FS docs development then i can submit my work to you which you can test on this dev server before committing it to FS Trunk. Second option is that i work on a single file, test it on my laptop and immediately submit it to FS trunk. But this could cause problem for end users (developers using FS doxygen docs) as many hyper links connected to undocumented files won't work till their docs are done and uploaded. We also need to decide on, 1. What Doxygen version to use? i use Archlinux which has the latest 1.6.x version, I can downgrade it to 1.4.x. 2. What format of documentation to adopt? I think currently we have HTML format only, but Doxygen can also generate PDF and CHM formats. Thank you. On Mon, Feb 22, 2010 at 9:00 AM, Yossi Neiman < freeswitch@cartissolutions.com> wrote:
I am not sure how many folks make use of the Doxygen documentation. I know I do all the time. I find that it provides a nice conceptual view of FreeSWITCH's API, which can make it very easy to find the functions and data types needed for writing modules for FreeSWITCH.
A person by the name of Mohammad Shahzad (apologies if I misspelled it) started to do a lot of work on revamping the Doxygen configuration for FreeSWITCH a few months back. The problem with the work that he did was that he used Doxygen 1.6.x specific configuration parameters that are not understood by the Doxygen 1.4.x tree (which is what we currently use in FreeSWITCH) or even the 1.5.x tree which is what is in Slackware. In my discussions with Michael Collins we have decided that it might not hurt to go ahead and move the Doxygen version forward to match the 1.6.x tree.
We are looking for somebody who has interest in working with the Doxygen configuration to continue the work that Mohammad had started and to help the project out. If you are such a person, please contact me off-list and I can provide further information.
Thanks!
Yossi Neiman
_______________________________________________ FreeSWITCH-users mailing list FreeSWITCH-users@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-users UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users http://www.freeswitch.org
-- Muhammad Shahzad ----------------------------------- CISCO Rich Media Communication Specialist (CRMCS) CISCO Certified Network Associate (CCNA) Cell: +92 334 422 40 88 MSN: shari_786pk@hotmail.com Email: shaheryarkh@googlemail.com
On Mon, Feb 22, 2010 at 2:00 AM, Muhammad Shahzad < shaheryarkh@googlemail.com> wrote:
Hi,
Its a quite embarrassing to admit that i could completed that work, not even able to submit what was done to FS trunk due to my own stupidity. Actually, we are having major power crisis in the country for last 1 years and most of power cuts are so long that even best UPS systems can't ensure 24/7 up time for our servers. About 3 months ago the development server i was working on for FS Docs was hit by this problem and its hard disk crashed, destroying all my hard work on FS Docs and mod_msn. It was my mistake that i didn't arrange for proper backup for my work due to shortage of resources and didn't inform the FS developers community about the loss.
I want to restart this work but don't want to take the lead on this due to issues described above. If you can arrange a common server for FS docs development then i can submit my work to you which you can test on this dev server before committing it to FS Trunk.
Second option is that i work on a single file, test it on my laptop and immediately submit it to FS trunk. But this could cause problem for end users (developers using FS doxygen docs) as many hyper links connected to undocumented files won't work till their docs are done and uploaded.
We also need to decide on,
1. What Doxygen version to use? i use Archlinux which has the latest 1.6.x version, I can downgrade it to 1.4.x. 2. What format of documentation to adopt? I think currently we have HTML format only, but Doxygen can also generate PDF and CHM formats.
Thank you.
If there is a compelling reason to use 1.6 then let's use it, but if not let's just stick with 1.4. As far as formats, HTML is definitely the most useful. I don't know that PDF or CHM is very useful for this kind of thing.
Thanks! And sorry to hear about your computer and power woes. Hope you recover soon. -MC
I bet someone would donate a shell account or VM somewhere so you can keep your work in a safe place. On Mon, Feb 22, 2010 at 10:22 AM, Michael Collins <msc@freeswitch.org>wrote:
On Mon, Feb 22, 2010 at 2:00 AM, Muhammad Shahzad < shaheryarkh@googlemail.com> wrote:
Hi,
Its a quite embarrassing to admit that i could completed that work, not even able to submit what was done to FS trunk due to my own stupidity. Actually, we are having major power crisis in the country for last 1 years and most of power cuts are so long that even best UPS systems can't ensure 24/7 up time for our servers. About 3 months ago the development server i was working on for FS Docs was hit by this problem and its hard disk crashed, destroying all my hard work on FS Docs and mod_msn. It was my mistake that i didn't arrange for proper backup for my work due to shortage of resources and didn't inform the FS developers community about the loss.
I want to restart this work but don't want to take the lead on this due to issues described above. If you can arrange a common server for FS docs development then i can submit my work to you which you can test on this dev server before committing it to FS Trunk.
Second option is that i work on a single file, test it on my laptop and immediately submit it to FS trunk. But this could cause problem for end users (developers using FS doxygen docs) as many hyper links connected to undocumented files won't work till their docs are done and uploaded.
We also need to decide on,
1. What Doxygen version to use? i use Archlinux which has the latest 1.6.x version, I can downgrade it to 1.4.x. 2. What format of documentation to adopt? I think currently we have HTML format only, but Doxygen can also generate PDF and CHM formats.
Thank you.
If there is a compelling reason to use 1.6 then let's use it, but if not let's just stick with 1.4. As far as formats, HTML is definitely the most useful. I don't know that PDF or CHM is very useful for this kind of thing.
Thanks! And sorry to hear about your computer and power woes. Hope you recover soon. -MC
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
-- Anthony Minessale II FreeSWITCH http://www.freeswitch.org/ ClueCon http://www.cluecon.com/ Twitter: http://twitter.com/FreeSWITCH_wire AIM: anthm MSN:anthony_minessale@hotmail.com <MSN%3Aanthony_minessale@hotmail.com> GTALK/JABBER/PAYPAL:anthony.minessale@gmail.com<PAYPAL%3Aanthony.minessale@gmail.com> IRC: irc.freenode.net #freeswitch FreeSWITCH Developer Conference sip:888@conference.freeswitch.org <sip%3A888@conference.freeswitch.org> iax:guest@conference.freeswitch.org/888 googletalk:conf+888@conference.freeswitch.org<googletalk%3Aconf%2B888@conference.freeswitch.org> pstn:+19193869900
I could. I have a server that is sitting idle while that we can use for that kind of stuff. Yossi, Muhammad and MSC , let's try to get this synced? I am in Mexico for the week and it is going to be hard to get anything done before March 2nd but this is a subject I definitely want to have a role in if possible. João Mesquita On Mon, Feb 22, 2010 at 2:34 PM, Anthony Minessale < anthony.minessale@gmail.com> wrote:
I bet someone would donate a shell account or VM somewhere so you can keep your work in a safe place.
On Mon, Feb 22, 2010 at 10:22 AM, Michael Collins <msc@freeswitch.org>wrote:
On Mon, Feb 22, 2010 at 2:00 AM, Muhammad Shahzad < shaheryarkh@googlemail.com> wrote:
Hi,
Its a quite embarrassing to admit that i could completed that work, not even able to submit what was done to FS trunk due to my own stupidity. Actually, we are having major power crisis in the country for last 1 years and most of power cuts are so long that even best UPS systems can't ensure 24/7 up time for our servers. About 3 months ago the development server i was working on for FS Docs was hit by this problem and its hard disk crashed, destroying all my hard work on FS Docs and mod_msn. It was my mistake that i didn't arrange for proper backup for my work due to shortage of resources and didn't inform the FS developers community about the loss.
I want to restart this work but don't want to take the lead on this due to issues described above. If you can arrange a common server for FS docs development then i can submit my work to you which you can test on this dev server before committing it to FS Trunk.
Second option is that i work on a single file, test it on my laptop and immediately submit it to FS trunk. But this could cause problem for end users (developers using FS doxygen docs) as many hyper links connected to undocumented files won't work till their docs are done and uploaded.
We also need to decide on,
1. What Doxygen version to use? i use Archlinux which has the latest 1.6.x version, I can downgrade it to 1.4.x. 2. What format of documentation to adopt? I think currently we have HTML format only, but Doxygen can also generate PDF and CHM formats.
Thank you.
If there is a compelling reason to use 1.6 then let's use it, but if not let's just stick with 1.4. As far as formats, HTML is definitely the most useful. I don't know that PDF or CHM is very useful for this kind of thing.
Thanks! And sorry to hear about your computer and power woes. Hope you recover soon. -MC
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
-- Anthony Minessale II
FreeSWITCH http://www.freeswitch.org/ ClueCon http://www.cluecon.com/ Twitter: http://twitter.com/FreeSWITCH_wire
AIM: anthm MSN:anthony_minessale@hotmail.com <MSN%3Aanthony_minessale@hotmail.com> GTALK/JABBER/PAYPAL:anthony.minessale@gmail.com<PAYPAL%3Aanthony.minessale@gmail.com> IRC: irc.freenode.net #freeswitch
FreeSWITCH Developer Conference sip:888@conference.freeswitch.org <sip%3A888@conference.freeswitch.org> iax:guest@conference.freeswitch.org/888 googletalk:conf+888@conference.freeswitch.org<googletalk%3Aconf%2B888@conference.freeswitch.org> pstn:+19193869900
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
Thanks everyone for your support. Lets get it started. Joao, whenever the server is arranged please provide me access to it, so i can set up base development environment with all necessary tools and utilities installed. Then we can discuss a SOP (standard operating procedure) to proceed with development. Thank you. 2010/2/22 João Mesquita <jmesquita@freeswitch.org>
I could. I have a server that is sitting idle while that we can use for that kind of stuff. Yossi, Muhammad and MSC , let's try to get this synced?
I am in Mexico for the week and it is going to be hard to get anything done before March 2nd but this is a subject I definitely want to have a role in if possible.
João Mesquita
On Mon, Feb 22, 2010 at 2:34 PM, Anthony Minessale < anthony.minessale@gmail.com> wrote:
I bet someone would donate a shell account or VM somewhere so you can keep your work in a safe place.
On Mon, Feb 22, 2010 at 10:22 AM, Michael Collins <msc@freeswitch.org>wrote:
On Mon, Feb 22, 2010 at 2:00 AM, Muhammad Shahzad < shaheryarkh@googlemail.com> wrote:
Hi,
Its a quite embarrassing to admit that i could completed that work, not even able to submit what was done to FS trunk due to my own stupidity. Actually, we are having major power crisis in the country for last 1 years and most of power cuts are so long that even best UPS systems can't ensure 24/7 up time for our servers. About 3 months ago the development server i was working on for FS Docs was hit by this problem and its hard disk crashed, destroying all my hard work on FS Docs and mod_msn. It was my mistake that i didn't arrange for proper backup for my work due to shortage of resources and didn't inform the FS developers community about the loss.
I want to restart this work but don't want to take the lead on this due to issues described above. If you can arrange a common server for FS docs development then i can submit my work to you which you can test on this dev server before committing it to FS Trunk.
Second option is that i work on a single file, test it on my laptop and immediately submit it to FS trunk. But this could cause problem for end users (developers using FS doxygen docs) as many hyper links connected to undocumented files won't work till their docs are done and uploaded.
We also need to decide on,
1. What Doxygen version to use? i use Archlinux which has the latest 1.6.x version, I can downgrade it to 1.4.x. 2. What format of documentation to adopt? I think currently we have HTML format only, but Doxygen can also generate PDF and CHM formats.
Thank you.
If there is a compelling reason to use 1.6 then let's use it, but if not let's just stick with 1.4. As far as formats, HTML is definitely the most useful. I don't know that PDF or CHM is very useful for this kind of thing.
Thanks! And sorry to hear about your computer and power woes. Hope you recover soon. -MC
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
-- Anthony Minessale II
FreeSWITCH http://www.freeswitch.org/ ClueCon http://www.cluecon.com/ Twitter: http://twitter.com/FreeSWITCH_wire
AIM: anthm MSN:anthony_minessale@hotmail.com <MSN%3Aanthony_minessale@hotmail.com> GTALK/JABBER/PAYPAL:anthony.minessale@gmail.com<PAYPAL%3Aanthony.minessale@gmail.com> IRC: irc.freenode.net #freeswitch
FreeSWITCH Developer Conference sip:888@conference.freeswitch.org <sip%3A888@conference.freeswitch.org> iax:guest@conference.freeswitch.org/888 googletalk:conf+888@conference.freeswitch.org<googletalk%3Aconf%2B888@conference.freeswitch.org> pstn:+19193869900
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
-- Muhammad Shahzad ----------------------------------- CISCO Rich Media Communication Specialist (CRMCS) CISCO Certified Network Associate (CCNA) Cell: +92 334 422 40 88 MSN: shari_786pk@hotmail.com Email: shaheryarkh@googlemail.com
On Tue, Feb 23, 2010 at 6:55 AM, Muhammad Shahzad < shaheryarkh@googlemail.com> wrote:
Thanks everyone for your support. Lets get it started.
Joao, whenever the server is arranged please provide me access to it, so i can set up base development environment with all necessary tools and utilities installed. Then we can discuss a SOP (standard operating procedure) to proceed with development.
Agreed. JM, when you get back home let's discuss this. I'll mention this on the conf call for tomorrow. -MC
Sorry folks. I won't be available till March 2nd when this trade show is finally ended. Will get it all setup next week and that's a promise. Regards, João Mesquita On Tue, Feb 23, 2010 at 3:26 PM, Michael Collins <msc@freeswitch.org> wrote:
On Tue, Feb 23, 2010 at 6:55 AM, Muhammad Shahzad < shaheryarkh@googlemail.com> wrote:
Thanks everyone for your support. Lets get it started.
Joao, whenever the server is arranged please provide me access to it, so i can set up base development environment with all necessary tools and utilities installed. Then we can discuss a SOP (standard operating procedure) to proceed with development.
Agreed. JM, when you get back home let's discuss this. I'll mention this on the conf call for tomorrow. -MC
_______________________________________________ FreeSWITCH-dev mailing list FreeSWITCH-dev@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-dev UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-dev http://www.freeswitch.org
2010/2/23 João Mesquita <jmesquita@freeswitch.org>
Sorry folks. I won't be available till March 2nd when this trade show is finally ended.
Will get it all setup next week and that's a promise.
Regards, João Mesquita
No worries! Thanks, MC
participants (5)
-
Anthony Minessale
-
João Mesquita
-
Michael Collins
-
Muhammad Shahzad
-
Yossi Neiman