[SciPy-dev] Duplicated docstring in Scipy Doc Wiki

Pauli Virtanen pav@iki...
Thu May 22 16:47:58 CDT 2008


Hi all,

to, 2008-05-22 kello 21:50 +0300, Pauli Virtanen kirjoitti:
> to, 2008-05-22 kello 11:28 -0700, joep kirjoitti:
> [clip]
> > However, when I do a search on the DocWiki for example for arccos (or
> > log, log10, exp, tan,...), I see it 9 times, and it is not clear which
> > ones refer to the same docstring and where several imports of the same
> > function are picked up separately, and which ones refer to actually
> > different functions in the source.
> [clip]
> > A recommendation for docstring editing might be to verify duplicates
> > and copy doc strings if the function is (almost) duplicated or
> > triplicated in the numpy source and possibly cross link different
> > versions.
> 
> This is a problem with the tool on handling extension objects and
> Pyrex-generated classes, and the editors shouldn't have to concern
> themselves with it. I'll fix it and remove any unedited duplicates from
> the wiki.

I corrected this problem on the Scipy Doc Wiki today. You can see many
automated changes in RecentChanges, but these only add links to the
Numpy source codes (as requested by Joe, IIRC) and I verified manually
that any real work wasn't clobbered.

	Pauli




More information about the Scipy-dev mailing list