Trac #34166: Fix docstring markup in sage/tests except sage/tests/boo…

…k_stein_modform.py

Part of #34157:
{{{
sage/tests/benchmark.py:68:1: RST203 Definition list ends without a
blank line; unexpected unindent.
sage/tests/article_heuberger_krenn_kropf_fsm-in-sage.py:10:1: RST301
Unexpected indentation.
sage/tests/article_heuberger_krenn_kropf_fsm-in-sage.py:13:1: RST201
Block quote ends without a blank line; unexpected unindent.
sage/tests/gosper-sum.py:2:1: RST399 Document or section may not begin
with a transition.
}}}

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

src/sage/tests/article_heuberger_krenn_kropf_fsm-in-sage.py

@@ -1,16 +1,18 @@
 r"""
-This file contains doctests of the article
+This file contains doctests of the article ::
 
     Automata and Transducers
     in the Computer Algebra System Sage
 
 by Clemens Heuberger, Daniel Krenn, and Sara Kropf, :arxiv:`1404.7458`.
 
 IF IT BECOMES NECESSARY TO CHANGE ANY TESTS IN THIS FILE, THERE
-NEEDS TO BE A ONE-YEAR DEPRECATION PERIOD. ALSO, PLEASE INFORM
-    Clemens Heuberger <[email protected]>,
-    Daniel Krenn <[email protected]>, AND
-    Sara Kropf <[email protected]>
+NEEDS TO BE A ONE-YEAR DEPRECATION PERIOD. ALSO, PLEASE INFORM:
+
+- Clemens Heuberger <[email protected]>,
+- Daniel Krenn <[email protected]>, AND
+- Sara Kropf <[email protected]>
+
 IN THIS CASE REGARDING THE CHANGES!
 """
 

src/sage/tests/benchmark.py

@@ -64,12 +64,16 @@ def run(self, systems=None, timeout=60, trials=1, sort=False, optional=False):
         given.
 
         INPUT:
-            systems -- list of strings of which systems to run tests on
-                if None, runs the standard systems
-            timeout -- how long (in seconds) to run each test for
-            trials -- integer, number of trials
-            sort -- whether to sort system names
-            optional -- if systems is None, whether to test optional systems
+
+        - systems -- optional list of strings of which systems to run tests on;
+          if ``None``, runs the standard systems
+        - timeout -- optional integer (default 60); how long (in seconds)
+          to run each test for
+        - trials -- optional integer (default 1); number of trials
+        - sort -- optional boolean (default ``False``); whether to sort
+          system names
+        - optional -- optional boolean (default ``False``);
+          if systems is ``None``, whether to test optional systems
 
         EXAMPLES::
 

src/sage/tests/gosper-sum.py

@@ -1,4 +1,6 @@
 """
+Some tests about Gosper sums.
+
 References
 ==========