On 2009-07-16, David Cournapeau <[email protected]> wrote:
> Hi Pauli,
>
> On Sat, Jul 4, 2009 at 9:59 PM, Pauli Virtanen<[email protected]> wrote:
>> Hi,
>>
>> When you add new functions to Numpy, please include
>>
>> .. versionadded:: 1.4.0
>
> What is the best way to do this in the reference guide directly as
> well (for C API). For example, I added the function npy_copysign for
> 1.4.0, documented in the c-api.coremath.rst, but I don't know where to
> put the versionadded.
In the Python docs, the versionadded:: typically is the last item
inside the function:: directive.
> More generally, I would like to follow our
> docstring format when documenting C functions, but how can I put the
> different sections in there (Parameters, Notes, etc...)
Yeah, currently there's no way to do that. I can probably add
numpy*function/cfunction/... etc. directives that allow this.
An alternative is to use
.. rubric:: Notes
to make the headings to appear.
--
Pauli Virtanen
_______________________________________________
NumPy-Discussion mailing list
[email protected]
http://mail.scipy.org/mailman/listinfo/numpy-discussion
