Various minor doc fixes

Author: jdemeyer

autogen/doc.py

@@ -13,13 +13,14 @@
 double_space = re.compile("  +")
 
 end_space = re.compile(r"(@\[end[a-z]*\])([A-Za-z])")
+end_paren = re.compile(r"(@\[end[a-z]*\])([(])")
 
 begin_verb = re.compile(r"@1")
 end_verb = re.compile(r"@[23] *@\[endcode\]")
 verb_loop = re.compile("^(    .*)@\[[a-z]*\]", re.MULTILINE)
 
 dollars = re.compile(r"@\[dollar\]\s*(.*?)\s*@\[dollar\]", re.DOTALL)
-doubledollars = re.compile(r"@\[doubledollar\]\s*(.*?)\s*@\[doubledollar\]", re.DOTALL)
+doubledollars = re.compile(r"@\[doubledollar\]\s*(.*?)\s*@\[doubledollar\] *", re.DOTALL)
 
 math_loop = re.compile(r"(@\[start[A-Z]*MATH\][^@]*)@\[[a-z]*\]")
 math_backslash = re.compile(r"(@\[start[A-Z]*MATH\][^@]*)=BACKSLASH=")
@@ -130,6 +131,10 @@ def raw_to_rest(doc):
     # insert a non-breaking space
     doc = end_space.sub("\\1\xa0\\2", doc)
 
+    # Similarly, for inline markup immediately followed by an open
+    # parenthesis, insert a space
+    doc = end_paren.sub("\\1 \\2", doc)
+
     # Fix labels and references
     doc = label_define.sub("", doc)
     doc = label_ref.sub("``\\3`` (in the PARI manual)", doc)
@@ -299,22 +304,22 @@ def get_rest_doc(function):
         <BLANKLINE>
         .. MATH::
         <BLANKLINE>
-            f(x) = \exp(-i\pi/24).\eta((x+1)/2)/\eta(x) {such that}
+            f(x) = \exp (-i\pi/24).\eta ((x+1)/2)/\eta (x) {such that}
             j = (f^{24}-16)^3/f^{24},
         <BLANKLINE>
         where :math:`j` is the elliptic :math:`j`-invariant (see the function :literal:`ellj`).
         If :math:`flag = 1`, returns
         <BLANKLINE>
         .. MATH::
         <BLANKLINE>
-            f_1(x) = \eta(x/2)/\eta(x) {such that}
+            f_1(x) = \eta (x/2)/\eta (x) {such that}
             j = (f_1^{24}+16)^3/f_1^{24}.
         <BLANKLINE>
         Finally, if :math:`flag = 2`, returns
         <BLANKLINE>
         .. MATH::
         <BLANKLINE>
-            f_2(x) = \sqrt{2}\eta(2x)/\eta(x) {such that}
+            f_2(x) = \sqrt{2}\eta (2x)/\eta (x) {such that}
             j = (f_2^{24}+16)^3/f_2^{24}.
         <BLANKLINE>
         Note the identities :math:`f^8 = f_1^8+f_2^8` and :math:`ff_1f_2 = \sqrt2`.

cypari2/gen.pyx

@@ -759,7 +759,8 @@ cdef class Gen(Gen_base):
     # obsolete: https://trac.sagemath.org/ticket/22165
     def polred(self, *args, **kwds):
         r'''
-        This function is :emphasis:`deprecated`, use :meth:`.polredbest` instead.
+        This function is :emphasis:`deprecated`,
+        use :meth:`~cypari2.gen.Gen_base.polredbest` instead.
         '''
         import warnings
         with warnings.catch_warnings():