changes according to referee's comments

Author: fchapoton

src/doc/en/reference/references/index.rst

@@ -1180,6 +1180,9 @@ REFERENCES:
              moduli spaces to Feynman integrals*, in Contemporary Mathematics
              vol 539, pages 27-52, 2011.
 
+.. [Bro2013] Francis Brown, *Single-valued motivic periods and multiple zeta
+             values*, Forum Math. Sigma 2 (2014), :doi:`10.1017/fms.2014.18`.
+
 .. [Bro2016] \A.E. Brouwer,
              Personal communication, 2016.
 

src/sage/modular/multiple_zeta.py

@@ -1083,9 +1083,15 @@ def iterated(self):
             return self.parent().iterated(self)
 
         def single_valued(self):
-            """
+            r"""
             Return the single-valued version of ``self``.
 
+            This is the projection map onto the sub-algebra of
+            single-valued motivic multiple zeta values, as defined by
+            F. Brown in [Bro2013]_.
+
+            This morphism of algebras sends in particular `\zeta(2)` to `0`.
+
             EXAMPLES::
 
                 sage: M = Multizetas(QQ)

src/sage/modular/multiple_zeta_F_algebra.py

@@ -716,7 +716,7 @@ def without_f2(self):
 
                 sage: from sage.modular.multiple_zeta_F_algebra import F_algebra
                 sage: F = F_algebra(QQ)
-                sage: t = 4*F("35")+F("27")
+                sage: t = 4 * F("35") + F("27")
                 sage: t.without_f2()
                 4*f3f5
             """
@@ -731,10 +731,10 @@ def single_valued(self):
 
                 sage: from sage.modular.multiple_zeta_F_algebra import F_algebra
                 sage: F = F_algebra(QQ)
-                sage: t = 4*F("2")+F("3")
+                sage: t = 4 * F("2") + F("3")
                 sage: t.single_valued()
                 2*f3
-                sage: t = 4*F("35")+F("27")
+                sage: t = 4 * F("35") + F("27")
                 sage: t.single_valued()
                 8*f3f5 + 8*f5f3
             """