[SciPy-Dev] Function of the :mod: wiki function
Sat Jul 10 16:27:41 CDT 2010
On Sat, Jul 10, 2010 at 5:22 PM, <firstname.lastname@example.org> wrote:
> On Sat, Jul 10, 2010 at 4:38 PM, David Goldsmith
> <email@example.com> wrote:
>> On Sat, Jul 10, 2010 at 10:07 AM, Jason Grout <firstname.lastname@example.org>
>>> On 7/9/10 6:48 PM, David Goldsmith wrote:
>>> > In docstrings like that for numpy.fft, which in edit mode begins:
>>> > Discrete Fourier Transform (:mod:`numpy.fft`)
>>> > =================================
>>> > what's the function of the :mod:? All it seems to do on being
>>> > rendered by the Wiki is generate a link back to it's own document.
>>> For reference, here is a list of things like :mod:
>>> (you probably already knew that, though)
>> No, I didn't thanks. That page indicates these things are to be used for
>> *cross*-referencing, i.e., what we're using single backticks for; my guess
>> is that someone used the :mod: before all our mark-up policies were
>> settled. So, I'm removing it; if someone later explains to me why it should
>> be there, I'll put it back in.
> don't remove them from the package titles, I think you are destroying
> the module index
If you are only talking about numpy, then the module index looks
different (numpy.doc.xxx seem to be automodules)
I thought only about the scipy docs, and I don't know the structure of
the numpy docs very well.
>>> SciPy-Dev mailing list
>> Mathematician: noun, someone who disavows certainty when their uncertainty
>> set is non-empty, even if that set has measure zero.
>> Hope: noun, that delusive spirit which escaped Pandora's jar and, with her
>> lies, prevents mankind from committing a general suicide. (As interpreted
>> by Robert Graves)
>> SciPy-Dev mailing list
More information about the SciPy-Dev