> Are able to use doxygen for Python code ? I thought it only worked  
> for C (and
> alike) ?
>
> IIRC correctly, it now does Python too. Let's see... here is an  
> example
> ## Documentation for this module.
> #
> # More details.
>
> ## Documentation for a function.
> #
> # More details.
> def func():
> pass
> Looks like ## replaces the /**

I never found it (although I haven't looked too hard), but I always  
thought there was an official way to document python code --  
minimally to put the documentation in the docstring following the  
function definition:

def func(..):
     """One liner.

     Continue docs -- some type of reStructredText style
     """
     pas

Isn't that the same docstring that ipython uses to bring up help,  
when you do:

In [1]: myobject.some_func?


So .. I guess I'm wondering why we want to break from the standard?

-steve



-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Numpy-discussion mailing list
Numpy-discussion@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/numpy-discussion

Reply via email to