[SciPy-dev] styleguide for info.py files?

Robert Cimrman cimrman3@ntc.zcu...
Mon Nov 19 09:36:40 CST 2007


Is there a recommended way of writing the info.py files in numpy/scipy 
trees? It might be good to follow similar convention to the docstrings, 
as it would make an automatic generation of 'printed' documentation easier.

I ask because I have created a short script (nothing fancy) for scanning 
the docstrings and creating a LaTeX-typeset pdf. An example can be found 
at http://ui505p06-mbs.ntc.zcu.cz/sfe/Documentation#Terms

Now I need to do something similar for the SciPy modules I have 
contributed (yes, end of year and evaluation time...). The minimal 
change to the infos required is to mark sections by colons (:A section:).


More information about the Scipy-dev mailing list