Trac #34172: Fix docstring markup in sage/groups and sage/misc

Part of #34157:
{{{
sage/groups/cubic_braid.py:1379:1: RST301 Unexpected indentation.
sage/groups/cubic_braid.py:1381:1: RST201 Block quote ends without a
blank line; unexpected unindent.
sage/misc/sagedoc.py:594:1: RST214 Inline literal start-string without
end-string.
sage/misc/sagedoc.py:670:1: RST214 Inline literal start-string without
end-string.
sage/misc/profiler.py:63:1: RST303 Unknown directive type "todo".
sage/misc/sage_input.py:1840:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/misc/sage_input.py:1843:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/misc/sage_input.py:2139:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/misc/sage_input.py:2248:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/misc/call.py:112:1: RST205 Explicit markup ends without a blank
line; unexpected unindent.
}}}

URL: https://trac.sagemath.org/34172
Reported by: klee
Ticket author(s): John Palmieri
Reviewer(s): Matthias Koeppe

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

@@ -215,6 +215,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