Trac #34164: Fix docstring markup in sage/plot and sage/graphs

Part of #34157:
{{{
sage/plot/polygon.py:99:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/plot/polygon.py:113:1: RST215 Inline interpreted text or phrase
reference start-string without end-string.
sage/graphs/dot2tex_utils.py:89:1: RST201 Block quote ends without a
blank line; unexpected unindent.
sage/graphs/dot2tex_utils.py:91:1: RST301 Unexpected indentation.
sage/graphs/graph_plot.py:50:1: RST299 The "csv-table" directive
requires content; none supplied.
}}}

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

src/sage/graphs/dot2tex_utils.py

@@ -77,11 +77,13 @@ def quoted_latex(x):
     """
     return re.sub("\"|\r|(%[^\n]*)?\n","", latex(x))
 
+
 def quoted_str(x):
-    """
-    Strips the string representation of ``x`` to make it suitable for
-    a ``dot2tex`` string, and especially a node label (``dot2tex``
-    gets confused by newlines, and braces)
+    r"""
+    Strip the string representation of ``x`` to make it suitable for
+    a ``dot2tex`` string, and especially a node label.
+
+    Indeed, ``dot2tex`` gets confused by newlines, and braces.
 
     EXAMPLES::
 

src/sage/plot/polygon.py

@@ -97,8 +97,9 @@ def _repr_(self):
 
     def __getitem__(self, i):
         """
-        Return `i`th vertex of Polygon primitive, starting count
-        from 0th vertex.
+        Return `i`-th vertex of Polygon primitive
+
+        It is starting count from 0th vertex.
 
         EXAMPLES::
 
@@ -111,9 +112,11 @@ def __getitem__(self, i):
 
     def __setitem__(self, i, point):
         """
-        Changes `i`th vertex of Polygon primitive, starting count
-        from 0th vertex.  Note that this only changes a vertex,
-        but does not create new vertices.
+        Change `i`-th vertex of Polygon primitive
+
+        It is starting count from 0th vertex.
+
+        Note that this only changes a vertex, but does not create new vertices.
 
         EXAMPLES::