Trac #34162: Fix docstring markup in sage/doctest

Part of #34157:
{{{
sage/doctest/sources.py:193:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/doctest/sources.py:239:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/doctest/sources.py:429:1: RST201 Block quote ends without a blank
line; unexpected unindent.
sage/doctest/sources.py:431:1: RST201 Block quote ends without a blank
line; unexpected unindent.
sage/doctest/sources.py:765:1: RST214 Inline literal start-string
without end-string.
sage/doctest/sources.py:765:1: RST214 Inline literal start-string
without end-string.
}}}

URL: https://trac.sagemath.org/34162
Reported by: klee
Ticket author(s): Frédéric Chapoton
Reviewer(s): Matthias Koeppe

Author: Release Manager

src/sage/doctest/sources.py

@@ -193,7 +193,7 @@ def _process_doc(self, doctests, doc, namespace, start):
 
         - ``namespace`` -- a dictionary or
           :class:`sage.doctest.util.RecordingDict`, used in the
-          creation of new :class:`doctest.DocTest`s.
+          creation of new :class:`doctest.DocTest` s.
 
         - ``start`` -- an integer, giving the line number of the start
           of this docstring in the larger file.
@@ -239,7 +239,7 @@ def _create_doctests(self, namespace, tab_okay=None):
 
         - ``namespace`` -- a dictionary or
           :class:`sage.doctest.util.RecordingDict`, used in the
-          creation of new :class:`doctest.DocTest`s.
+          creation of new :class:`doctest.DocTest` s.
 
         - ``tab_okay`` -- whether tabs are allowed in this source.
 
@@ -418,7 +418,7 @@ def __init__(self, basename, source, options, printpath, lineno_shift=0):
         DocTestSource.__init__(self, options)
 
     def __iter__(self):
-        """
+        r"""
         Iterating over this source yields pairs ``(lineno, line)``.
 
         EXAMPLES::
@@ -755,21 +755,20 @@ def create_doctests(self, namespace):
         return self._create_doctests(namespace)
 
     def _test_enough_doctests(self, check_extras=True, verbose=True):
-        """
+        r"""
         This function checks to see that the doctests are not getting
         unexpectedly skipped.  It uses a different (and simpler) code
         path than the doctest creation functions, so there are a few
         files in Sage that it counts incorrectly.
 
         INPUT:
 
-        - ``check_extras`` -- bool (default True), whether to check if
-          doctests are created that don't correspond to either a
-          ``sage: `` or a ``>>> `` prompt.
+        - ``check_extras`` -- bool (default ``True``), whether to check if
+          doctests are created that do not correspond to either a ``sage: ``
+          or a ``>>> `` prompt
 
-        - ``verbose`` -- bool (default True), whether to print
-          offending line numbers when there are missing or extra
-          tests.
+        - ``verbose`` -- bool (default ``True``), whether to print
+          offending line numbers when there are missing or extra tests
 
         TESTS::