Trac #34602: add some missing EXAMPLES

that apparently do not provoke any rst error

URL: https://trac.sagemath.org/34602
Reported by: chapoton
Ticket author(s): Frédéric Chapoton
Reviewer(s): Marc Mezzarobba

Author: Release Manager

src/sage/categories/magmas.py

@@ -774,12 +774,13 @@ def product(self, x, y):
 
         def __init_extra__(self):
             """
+            EXAMPLES::
+
                 sage: S = Semigroups().example("free")
                 sage: S('a') * S('b') # indirect doctest
                 'ab'
                 sage: S('a').__class__._mul_ == S('a').__class__._mul_parent
                 True
-
             """
             # This should instead register the multiplication to the coercion model
             # But this is not yet implemented in the coercion model

src/sage/combinat/sf/sf.py

@@ -1605,6 +1605,8 @@ def __init__(self, t, domain, codomain):
 
     def __call__(self, partition):
         """
+        EXAMPLES::
+
             sage: Sym = SymmetricFunctions(QQ['x'])
             sage: p = Sym.p(); s = Sym.s()
             sage: p[1] + s[1]                           # indirect doctest

src/sage/functions/bessel.py

@@ -1434,6 +1434,8 @@ def _derivative_(self, a, z, diff_param=None):
 
     def _print_latex_(self, a, z):
         """
+        EXAMPLES::
+
             sage: latex(struve_L(2,x))
             L_{{2}}({x})
         """

src/sage/groups/perm_gps/partn_ref/automorphism_group_canonical_label.pyx

@@ -99,15 +99,15 @@ REFERENCE:
 
 """
 
-#*****************************************************************************
+# ****************************************************************************
 #       Copyright (C) 2006 - 2011 Robert L. Miller <[email protected]>
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 # the Free Software Foundation, either version 2 of the License, or
 # (at your option) any later version.
-#                  http://www.gnu.org/licenses/
-#*****************************************************************************
+#                  https://www.gnu.org/licenses/
+# ****************************************************************************
 
 from libc.string cimport memcmp, memcpy
 from cysignals.memory cimport sig_malloc, sig_realloc, sig_free
@@ -134,24 +134,25 @@ cdef int compare_structures_trivial(int *gamma_1, int *gamma_2, void *S1, void *
 def test_get_aut_gp_and_can_lab_trivially(int n=6,
     list partition=[[0,1,2],[3,4],[5]], canonical_label=True, base=False):
     """
-    sage: tttt = sage.groups.perm_gps.partn_ref.automorphism_group_canonical_label.test_get_aut_gp_and_can_lab_trivially
-    sage: tttt()
-    12
-    sage: tttt(canonical_label=False, base=False)
-    12
-    sage: tttt(canonical_label=False, base=True)
-    12
-    sage: tttt(canonical_label=True, base=True)
-    12
-    sage: tttt(n=0, partition=[])
-    1
-    sage: tttt(n=0, partition=[], canonical_label=False, base=False)
-    1
-    sage: tttt(n=0, partition=[], canonical_label=False, base=True)
-    1
-    sage: tttt(n=0, partition=[], canonical_label=True, base=True)
-    1
+    TESTS::
 
+        sage: tttt = sage.groups.perm_gps.partn_ref.automorphism_group_canonical_label.test_get_aut_gp_and_can_lab_trivially
+        sage: tttt()
+        12
+        sage: tttt(canonical_label=False, base=False)
+        12
+        sage: tttt(canonical_label=False, base=True)
+        12
+        sage: tttt(canonical_label=True, base=True)
+        12
+        sage: tttt(n=0, partition=[])
+        1
+        sage: tttt(n=0, partition=[], canonical_label=False, base=False)
+        1
+        sage: tttt(n=0, partition=[], canonical_label=False, base=True)
+        1
+        sage: tttt(n=0, partition=[], canonical_label=True, base=True)
+        1
     """
     cdef aut_gp_and_can_lab *output
     cdef Integer I = Integer(0)

src/sage/knots/knotinfo.py

@@ -375,33 +375,35 @@ def items(self):
     @cached_method
     def __getitem__(self, item):
         r"""
-        sage: from sage.knots.knotinfo import KnotInfo
-        sage: L = KnotInfo.L4a1_0
-        sage: L[L.items.alternating]
-        'Y'
-        sage: L[L.items.arc_notation]
-        '{{6, 4}, {3, 5}, {4, 2}, {1, 3}, {2, 6}, {5, 1}}'
-        sage: L[L.items.braid_notation]
-        '{3, {-2, -2, -1, 2, -1}}'
-        sage: L[0]
-        Traceback (most recent call last):
-        ...
-        KeyError: "Item must be an instance of <enum 'KnotInfoColumns'>"
+        EXAMPLES::
+
+            sage: from sage.knots.knotinfo import KnotInfo
+            sage: L = KnotInfo.L4a1_0
+            sage: L[L.items.alternating]
+            'Y'
+            sage: L[L.items.arc_notation]
+            '{{6, 4}, {3, 5}, {4, 2}, {1, 3}, {2, 6}, {5, 1}}'
+            sage: L[L.items.braid_notation]
+            '{3, {-2, -2, -1, 2, -1}}'
+            sage: L[0]
+            Traceback (most recent call last):
+            ...
+            KeyError: "Item must be an instance of <enum 'KnotInfoColumns'>"
         """
         if not isinstance(item, KnotInfoColumns):
-            raise KeyError('Item must be an instance of %s' %(KnotInfoColumns))
+            raise KeyError('Item must be an instance of %s' % (KnotInfoColumns))
         if item.column_type() == item.types.OnlyLinks and self.is_knot():
-            raise KeyError('Item not available for knots' %(KnotInfoColumns))
+            raise KeyError('Item not available for knots' % (KnotInfoColumns))
         if item.column_type() == item.types.OnlyKnots and not self.is_knot():
-            raise KeyError('Item not available for links' %(KnotInfoColumns))
+            raise KeyError('Item not available for links' % (KnotInfoColumns))
 
         l = db.read(item)
         ind = db.read_row_dict()[self.name][0]
         offset = 0
         if item.column_type() == item.types.OnlyLinks:
             offset = self._offset_knots()
 
-        return l[ind-offset]
+        return l[ind - offset]
 
     def _offset_knots(self):
         r"""

src/sage/rings/padics/padic_capped_absolute_element.pyx

@@ -9,18 +9,16 @@ AUTHORS:
 - Genya Zaytman: documentation
 - David Harvey: doctests
 """
-
-#*****************************************************************************
+# ****************************************************************************
 #       Copyright (C) 2007-2013 David Roe <[email protected]>
 #                               William Stein <[email protected]>
 #
 #  Distributed under the terms of the GNU General Public License (GPL)
 #  as published by the Free Software Foundation; either version 2 of
 #  the License, or (at your option) any later version.
 #
-#                  http://www.gnu.org/licenses/
-#*****************************************************************************
-
+#                  https://www.gnu.org/licenses/
+# ****************************************************************************
 include "sage/libs/linkages/padics/mpz.pxi"
 include "CA_template.pxi"
 
@@ -89,6 +87,8 @@ cdef class pAdicCappedAbsoluteElement(CAElement):
     """
     def lift(self):
         """
+        EXAMPLES::
+
             sage: R = ZpCA(3)
             sage: R(10).lift()
             10