I’ve got a somewhat complete reference for the python interface of
gnuradio radio done now. It can be found at:
Any suggestions on how we could improve these docs?
I also have two questions:
- I need improved docstrings for the subpackages. In particular
noaa, pager, and video_sdl. Suggestions from people who know what
these are would be much appreciated.
- A lot of python blocks contain doxygen markup (e.g. @param).
Anyone object to me changing this to a more pythonesque format since
we’re not using doxygen for the python code? For example:
can be easily parsed by sphinx.
I’ve also modifed doxyxml so that it extracts parameter
descriptions from the doxygen xml, and swig_doc.py so that it
generates docstrings for the swiged blocks in the above format.
Things to do:
- Add a sphinx extension to automate the inclusion of signal processing
- Handling of latex formatted math notation.