[Numpy-discussion] Extending documentation to c code

[David Cournapeau]

On Tue, May 25, 2010 at 11:18 PM, Benjamin Root <ben.root at ou.edu> wrote:
>
>> it does - I looked into synopsis because we could use rest, and I
>> don't think anyone wants to go the doxygen route.
>
> I am curious as to why doxygen isn't a viable option.  While I don't have
> experience with the other suggestions, I have used doxygen in a few of my
> personall projects and have been quite happy with it serving as internal
> documentation.

It is yet another format to use inside C sources (I don't think
doxygen supports rest), and I would rather have something that is
similar, ideally integrated into sphinx. It also generates rather ugly
doc by default,

David