diff --git a/doc/install.rst b/doc/install.rst index d80e7a71..6139efea 100644 --- a/doc/install.rst +++ b/doc/install.rst @@ -77,26 +77,28 @@ numpydoc_xref_aliases : dict This option depends on the ``numpydoc_xref_param_type`` option being ``True``. numpydoc_xref_ignore : set or ``"all"`` - How to handle terms not in ``numpydoc_xref_aliases`` when - ``numpydoc_xref_aliases=True``. The value can either be a ``set`` - containing terms to ignore, or ``"all"``. In the former case, the set - contains words not to cross-reference. Most likely, these are common words - used in parameter type descriptions that may be confused for - classes of the same name. For example:: - - numpydoc_xref_ignore = {'type', 'optional', 'default'} - - The default is an empty set. - - If the ``numpydoc_xref_ignore="all"``, then all unrecognized terms are - ignored, i.e. terms not in ``numpydoc_xref_aliases`` are *not* wrapped in - ``:obj:`` roles. - This configuration parameter may be useful if you only want create - cross references for a small number of terms. In this case, including the - desired cross reference mappings in ``numpydoc_xref_aliases`` and setting - ``numpydoc_xref_ignore="all"`` is more convenient than explicitly listing - terms to ignore in a set. + How to handle terms not in ``numpydoc_xref_aliases`` when + ``numpydoc_xref_aliases=True``. The value can either be a ``set`` + containing terms to ignore, or ``"all"``. In the former case, the set + contains words not to cross-reference. Most likely, these are common words + used in parameter type descriptions that may be confused for + classes of the same name. For example:: + + numpydoc_xref_ignore = {'type', 'optional', 'default'} + + The default is an empty set. + + If the ``numpydoc_xref_ignore="all"``, then all unrecognized terms are + ignored, i.e. terms not in ``numpydoc_xref_aliases`` are *not* wrapped in + ``:obj:`` roles. + This configuration parameter may be useful if you only want create + cross references for a small number of terms. In this case, including the + desired cross reference mappings in ``numpydoc_xref_aliases`` and setting + ``numpydoc_xref_ignore="all"`` is more convenient than explicitly listing + terms to ignore in a set. numpydoc_edit_link : bool - .. deprecated:: edit your HTML template instead + .. deprecated:: 0.7.0 + + edit your HTML template instead Whether to insert an edit link after docstrings.