Trac #34170: Fix docstring markup in sage/coding

Part of #34157:
{{{
sage/coding/gabidulin_code.py:534:1: RST218 Literal block expected; none
found.
sage/coding/ag_code.py:35:1: RST303 Unknown directive type "toctree".
sage/coding/self_dual_codes.py:228:1: RST218 Literal block expected;
none found.
sage/coding/linear_code_no_metric.py:755:1: RST204 Enumerated list ends
without a blank line; unexpected unindent.
sage/coding/grs_code.py:1201:1: RST202 Bullet list ends without a blank
line; unexpected unindent.
sage/coding/grs_code.py:1201:1: RST213 Inline emphasis start-string
without end-string.
sage/coding/guruswami_sudan/interpolation.py:41:1: RST218 Literal block
expected; none found.
}}}

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

Author: Release Manager

src/sage/coding/gabidulin_code.py

@@ -530,9 +530,9 @@ class GabidulinPolynomialEvaluationEncoder(Encoder):
 
         (p(\alpha_1), \dots, p(\alpha_n)).
 
-    TESTS::
+    TESTS:
 
-    This module uses the following experimental feature:
+    This module uses the following experimental feature.
     This test block is here only to trigger the experimental warning so it does not
     interferes with doctests::
 

src/sage/coding/grs_code.py

@@ -1199,7 +1199,7 @@ def _decode_to_code_and_message(self, r):
 
           * ``c`` is the representation of ``r`` decoded in the ambient
             space of the associated code of ``self``
-          *``f`` its representation in the message space of ``self``
+          * ``f`` its representation in the message space of ``self``
 
         EXAMPLES::
 

src/sage/coding/guruswami_sudan/interpolation.py

@@ -39,10 +39,10 @@ def _flatten_once(lstlst):
 
     EXAMPLES::
 
-    sage: from sage.coding.guruswami_sudan.interpolation import _flatten_once
-    sage: ll = [[1,2], [3,4], [5,6]]
-    sage: list(_flatten_once(ll))
-    [1, 2, 3, 4, 5, 6]
+        sage: from sage.coding.guruswami_sudan.interpolation import _flatten_once
+        sage: ll = [[1,2], [3,4], [5,6]]
+        sage: list(_flatten_once(ll))
+        [1, 2, 3, 4, 5, 6]
     """
     for lst in lstlst:
         for e in lst:

src/sage/coding/linear_code_no_metric.py

@@ -753,10 +753,12 @@ def __getitem__(self, i):
            ``[(i*a^0 +(p-1)*a^1 +...+ (p-1)*a^(m-1))*G[0] for i in range(p)]``
         4. Then, we move to G[1]:
            ``[i*a^0 * G[0] + a^0*G[1] for i in range(p)]``,
-         and so on.
-         Hence the `i`-th element can be obtained by the p-adic expansion
-         of `i` as ``[i_0, i_1, ...,i_{m-1}, i_m, i_{m+1}, ..., i_{km-1}].``
-         The element that is generated is:
+
+        and so on.
+        Hence the `i`-th element can be obtained by the p-adic expansion
+        of `i` as ``[i_0, i_1, ...,i_{m-1}, i_m, i_{m+1}, ..., i_{km-1}].``
+
+        The element that is generated is:
 
         .. MATH::
 

src/sage/coding/self_dual_codes.py

@@ -226,16 +226,16 @@ def _H8():
 
     EXAMPLES::
 
-    sage: from sage.coding.self_dual_codes import _H8
-    sage: _H8()
-    [ 1  1  1  1  1  1  1  1]
-    [ 1 -1  1 -1  1 -1  1 -1]
-    [ 1  1 -1 -1  1  1 -1 -1]
-    [ 1 -1 -1  1  1 -1 -1  1]
-    [ 1  1  1  1 -1 -1 -1 -1]
-    [ 1 -1  1 -1 -1  1 -1  1]
-    [ 1  1 -1 -1 -1 -1  1  1]
-    [ 1 -1 -1  1 -1  1  1 -1]
+        sage: from sage.coding.self_dual_codes import _H8
+        sage: _H8()
+        [ 1  1  1  1  1  1  1  1]
+        [ 1 -1  1 -1  1 -1  1 -1]
+        [ 1  1 -1 -1  1  1 -1 -1]
+        [ 1 -1 -1  1  1 -1 -1  1]
+        [ 1  1  1  1 -1 -1 -1 -1]
+        [ 1 -1  1 -1 -1  1 -1  1]
+        [ 1  1 -1 -1 -1 -1  1  1]
+        [ 1 -1 -1  1 -1  1  1 -1]
     """
     return matrix(ZZ, [[1, 1, 1, 1, 1, 1, 1, 1],\
                     [1, -1, 1, -1, 1, -1, 1, -1],\

src/tox.ini

@@ -209,6 +209,7 @@ rst-roles =
 rst-directives =
     automethod,
     autofunction,
+    toctree,
     MODULEAUTHOR,
     ONLY,
     PLOT,