[Numpy-discussion] "import numpy" performance

Pauli Virtanen pav@iki...
Mon Jul 2 16:24:29 CDT 2012


02.07.2012 21:17, Andrew Dalke kirjoitti:
[clip]
> 1) remove "add_newdocs" and put the docstrings in the C code
>  'add_newdocs' still needs to be there,

The docstrings need to be in an easily parseable format, because of the
online documentation editor. Keeping the current format may be the
easiest as that already works.

Moving them in the middle of other C code won't do, but a header file
e.g. generated at build-time should work. This is how it's currently
done with the ufunc docstrings, and it should work also for everything else.

The commit statistics for add_newdocs.py are somewhat misleading ---
since 2008, many of the documentation edits went in the online way, and
these only show up in a single large commit, usually before releases.

-- 
Pauli Virtanen



More information about the NumPy-Discussion mailing list