On Sat, Jul 10, 2010 at 4:33 PM,  <span dir="ltr">&lt;<a href="mailto:josef.pktd@gmail.com">josef.pktd@gmail.com</a>&gt;</span> wrote:<br><div class="gmail_quote"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On Sat, Jul 10, 2010 at 6:21 PM, David Goldsmith<br>
<div><div></div><div class="h5">&lt;<a href="mailto:d.l.goldsmith@gmail.com">d.l.goldsmith@gmail.com</a>&gt; wrote:<br>
&gt; On Sat, Jul 10, 2010 at 2:22 PM, &lt;<a href="mailto:josef.pktd@gmail.com">josef.pktd@gmail.com</a>&gt; wrote:<br>
&gt;&gt;<br>
&gt;&gt; On Sat, Jul 10, 2010 at 4:38 PM, David Goldsmith<br>
&gt;&gt; &lt;<a href="mailto:d.l.goldsmith@gmail.com">d.l.goldsmith@gmail.com</a>&gt; wrote:<br>
&gt;&gt; &gt; On Sat, Jul 10, 2010 at 10:07 AM, Jason Grout<br>
&gt;&gt; &gt; &lt;<a href="mailto:jason-sage@creativetrax.com">jason-sage@creativetrax.com</a>&gt;<br>
&gt;&gt; &gt; wrote:<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; On 7/9/10 6:48 PM, David Goldsmith wrote:<br>
&gt;&gt; &gt;&gt; &gt; In docstrings like that for numpy.fft, which in edit mode begins:<br>
&gt;&gt; &gt;&gt; &gt;<br>
&gt;&gt; &gt;&gt; &gt; Discrete Fourier Transform (:mod:`numpy.fft`)<br>
&gt;&gt; &gt;&gt; &gt; =================================<br>
&gt;&gt; &gt;&gt; &gt;<br>
&gt;&gt; &gt;&gt; &gt; what&#39;s the function of the :mod:?  All it seems to do on being<br>
&gt;&gt; &gt;&gt; &gt; rendered by the Wiki is generate a link back to it&#39;s own document.<br>
&gt;&gt; &gt;&gt; &gt;<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; For reference, here is a list of things like :mod:<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; <a href="http://sphinx.pocoo.org/markup/inline.html" target="_blank">http://sphinx.pocoo.org/markup/inline.html</a><br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; (you probably already knew that, though)<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; No, I didn&#39;t thanks.  That page indicates these things are to be used<br>
&gt;&gt; &gt; for<br>
&gt;&gt; &gt; *cross*-referencing, i.e., what we&#39;re using single backticks for; my<br>
&gt;&gt; &gt; guess<br>
&gt;&gt; &gt; is that someone used the :mod: before all our mark-up policies were<br>
&gt;&gt; &gt; settled.  So, I&#39;m removing it; if someone later explains to me why it<br>
&gt;&gt; &gt; should<br>
&gt;&gt; &gt; be there, I&#39;ll put it back in.<br>
&gt;&gt;<br>
&gt;&gt; don&#39;t remove them from the package titles, I think you are destroying<br>
&gt;&gt; the module index<br>
&gt;&gt;<br>
&gt;&gt; <a href="http://docs.scipy.org/doc/scipy/reference/modindex.html" target="_blank">http://docs.scipy.org/doc/scipy/reference/modindex.html</a><br>
&gt;<br>
&gt; Ah, OK, this is the info I was looking for: they do serve a (non-circular)<br>
&gt; function I was unaware of.  Thanks, I&#39;ll leave them in; is there any way to<br>
&gt; remove their link nature in the Wiki so that others don&#39;t make the same<br>
&gt; mistake again in the future, (i.e., think that they&#39;re creating a redundant<br>
&gt; circular reference and thus remove them)?<br>
<br>
</div></div>Sorry, my mistake, I mixed up the link and the link target<br>
.. module::   directive indicates the module target and causes the<br>
entry in the module index<br>
<br>
:mod: is the link and semantic markup.<br>
<br>
I still like the full path rendering that :mod: produces in the title.<br></blockquote><div><br>But it&#39;s to itself - what&#39;s the point?<br><br>DG<br>
</div></div>