Merge #34172

src/sage/groups/cubic_braid.py

@@ -1373,13 +1373,13 @@ def _element_constructor_(self, x, **kwds):
  INPUT:
 
  - ``x`` -- can be one of the following:
- -- an instance of the element class of ``self`` (but possible to a different parent).
- -- an instance of the element class of the braid group.
- -- a tuple representing a braid in Tietze form.
- -- an instance of an element class of a parent P such that there is a map from ``self`` to P
+ - an instance of the element class of ``self`` (but possible to a different parent).
+ - an instance of the element class of the braid group.
+ - a tuple representing a braid in Tietze form.
+ - an instance of an element class of a parent P such that there is a map from ``self`` to P
  having :meth:`lift`, for example an element of an alternative realization of ``self``, such
  as the classical realization.
- -- any other object which works for the element constructor of :class:`FinitelyPresentedGroup`.
+ - any other object which works for the element constructor of :class:`FinitelyPresentedGroup`.
 
  OUTPUT:
 

src/sage/misc/call.py

@@ -109,10 +109,12 @@ def __hash__(self):
  This method tries to ensure that, when two ``attrcall``
  objects are equal, they have the same hash value.
 
- .. warning:: dicts are not hashable, so we instead hash their
- items; however the order of those items might differ. The
- proper fix would be to use a frozen dict for ``kwds``, when
- frozen dicts will be available in Python.
+ .. warning::
+
+ dicts are not hashable, so we instead hash their
+ items; however the order of those items might differ. The
+ proper fix would be to use a frozen dict for ``kwds``, when
+ frozen dicts will be available in Python.
 
  EXAMPLES::
 

src/sage/misc/profiler.py

@@ -61,7 +61,7 @@ class Profiler:
 
  .. SEEALSO:: :func:`runsnake`
 
- .. todo::
+ .. TODO::
 
  - Add Pyrex source code inspection (I assume it doesn't
  currently do this)

src/sage/misc/sage_input.py

@@ -1838,11 +1838,11 @@ def __init__(self, sib, func, args, kwargs):
 
  - ``func`` - a :class:`SageInputExpression` representing a function
 
- - ``args`` - a list of :class:`SageInputExpression`s representing the
- positional arguments
+ - ``args`` - a list of instances of :class:`SageInputExpression`
+ representing the positional arguments
 
- - ``kwargs`` -- a dictionary mapping strings to
- :class:`SageInputExpression`s representing the keyword arguments
+ - ``kwargs`` -- a dictionary mapping strings to instances of
+ :class:`SageInputExpression` representing the keyword arguments
 
  EXAMPLES::
 
@@ -2137,8 +2137,8 @@ def __init__(self, sib, values, is_list):
 
  - ``sib`` -- a :class:`SageInputBuilder`
 
- - ``values`` -- a list of :class:`SageInputExpression`s representing the
- elements of this tuple
+ - ``values`` -- a list of instances of :class:`SageInputExpression`
+ representing the elements of this tuple
 
  - ``is_list`` -- is True if this class represents a list, False for a
  tuple
@@ -2246,7 +2246,7 @@ def __init__(self, sib, entries):
 
  - ``sib`` -- a :class:`SageInputBuilder`
 
- - ``entries`` -- a list of pairs of :class:`SageInputExpression`s
+ - ``entries`` -- a list of pairs of :class:`SageInputExpression`
  representing the entries of this dict
 
  EXAMPLES::

src/tox.ini

@@ -214,6 +214,8 @@ rst-directives =
 extend-ignore =
  # Ignore RST306 Unknown target name -- because of references to the global bibliography
  RST306
+exclude =
+ sage/misc/sagedoc.py
 
 [pytest]
 python_files = *_test.py