[SciPy-Dev] Using sphinx :func: markup in docstring

Pauli Virtanen pav at iki.fi
Mon Mar 25 04:39:24 EDT 2013


Warren Weckesser <warren.weckesser <at> gmail.com> writes:
> Is there a policy on using Sphinx hyperlinking references in
> docstrings?  There are a couple references in scipy.stats that look
> like they are intended to use Sphinx markup, but they don't actually
> create links in the HTML output.  Specifically, the ranksums docstring
> refers to `stats.mannwhitneyu`_, and f_oneway refers to
> `stats.kruskal`_.  These do not create links in the HTML output.  The
> only way I've been able to get a link generated is to use, e.g.,
> :func:`scipy.stats.kruskal`.

`scipy.stats.kruskal` should also generate a link (note: no trailing _).

-- 
Pauli Virtanen





More information about the SciPy-Dev mailing list