[Patch-gnuradio] Doxygen Enhancements

[Firas Abbas]

Hi,

I did some work to enhance gnuradio doxygen generated documentation. The work 
includes :

1) Enabling Tree view (very useful).

2) Current Gnuradio documentation had problems when generating python using 
doxygen + doxypy.py.  The problem is that if we want to keep the code docstring 
we will not be able to generate the required documentation using the above tool 
combinations. I emailed the creator of doxypy and explained the problem to him. 
He modified his doxypy code to solve this problem. Now, the new doxypy.py is 
working perfectly with doxygen without the need to do any gnuradio source code 
modifications.

3) The complete source code (*.h, *.cc and *.py) now included in the generated 
doxygen documentation. I think this is useful to examine class implentation 
directly in case the written documenation is poor.

4) All the class are sorted alphabetically.



Dear gnuradio Administrators,

I hope from you to apply this patch as quick as possible, because I have about 
8 work-off days, and I'm planning to invest this time to enhance gnuradio 
source files documentation.



The patch (new doxypy.py + new Doxyfile.in) can be found at:

http://rapidshare.com/files/170887092/new_doxygen.diff


Best Regards,


Firas