Merge pull request matplotlib#26102 from oscargus/mathtextdocgeneration

Start basing mathtext tutorial on mathtext parser

Author: anntzer

doc/sphinxext/math_symbol_table.py

@@ -9,28 +9,23 @@
      r"""\alpha \beta \gamma \chi \delta \epsilon \eta \iota \kappa
          \lambda \mu \nu \omega \phi \pi \psi \rho \sigma \tau \theta
          \upsilon \xi \zeta \digamma \varepsilon \varkappa \varphi
-         \varpi \varrho \varsigma \vartheta"""],
+         \varpi \varrho \varsigma \vartheta""".split()],
     ["Upper-case Greek",
      8,
      r"""\Delta \Gamma \Lambda \Omega \Phi \Pi \Psi \Sigma \Theta
-     \Upsilon \Xi \mho \nabla"""],
+     \Upsilon \Xi \mho \nabla""".split()],
     ["Hebrew",
      6,
-     r"""\aleph \beth \daleth \gimel"""],
+     r"""\aleph \beth \daleth \gimel""".split()],
     ["Delimiters",
      6,
-     r"""| \{ \lfloor / \Uparrow \llcorner \vert \} \rfloor \backslash
-         \uparrow \lrcorner \| \langle \lceil [ \Downarrow \ulcorner
-         \Vert \rangle \rceil ] \downarrow \urcorner"""],
+     _mathtext.Parser._delims],
     ["Big symbols",
      6,
-     r"""\bigcap \bigcup \bigodot \bigoplus \bigotimes \biguplus
-         \bigvee \bigwedge \coprod \oint \prod \sum \int"""],
+     _mathtext.Parser._overunder_symbols | _mathtext.Parser._dropsub_symbols],
     ["Standard function names",
      6,
-     r"""\arccos \csc \ker \min \arcsin \deg \lg \Pr \arctan \det \lim
-         \gcd \ln \sup \cot \hom \log \tan \coth \inf \max \tanh
-         \sec \arg \dim \liminf \sin \cos \exp \limsup \sinh \cosh"""],
+     {fr"\{fn}" for fn in _mathtext.Parser._function_names}],
     ["Binary operation and relation symbols",
      4,
      r"""\ast \pm \slash \cap \star \mp \cup \cdot \uplus
@@ -62,7 +57,7 @@
      \lneqq \gneqq \ntriangleright \lnsim \gnsim \ntrianglerighteq
      \coloneq \eqsim \nequiv \napprox \nsupset \doublebarwedge \nVdash
      \Doteq \nsubset \eqcolon \ne
-     """],
+     """.split()],
     ["Arrow symbols",
      4,
      r"""\leftarrow \longleftarrow \uparrow \Leftarrow \Longleftarrow
@@ -85,7 +80,7 @@
      \nrightarrow \nLeftarrow \nRightarrow \nleftrightarrow
      \nLeftrightarrow \to \Swarrow \Searrow \Nwarrow \Nearrow
      \leftsquigarrow
-     """],
+     """.split()],
     ["Miscellaneous symbols",
      4,
      r"""\neg \infty \forall \wp \exists \bigstar \angle \partial
@@ -95,7 +90,7 @@
      \hslash \vdots \blacksquare \ldots \blacktriangle \ddots \sharp
      \prime \blacktriangledown \Im \flat \backprime \Re \natural
      \circledS \P \copyright \ss \circledR \S \yen \AA \checkmark \$
-     \iiint \iint \oiiint"""]
+     \cent \triangle \QED \sinewave""".split()]
 ]
 
 
@@ -110,7 +105,7 @@ def render_symbol(sym):
 
     lines = []
     for category, columns, syms in symbols:
-        syms = sorted(syms.split())
+        syms = sorted(list(syms))
         columns = min(columns, len(syms))
         lines.append("**%s**" % category)
         lines.append('')
@@ -155,7 +150,6 @@ def setup(app):
     for category, columns, syms in symbols:
         if category == "Standard Function Names":
             continue
-        syms = syms.split()
         for sym in syms:
             if len(sym) > 1:
                 all_symbols[sym[1:]] = None

lib/matplotlib/_mathtext.py

@@ -1772,7 +1772,7 @@ class _MathStyle(enum.Enum):
 
     _overunder_functions = set("lim liminf limsup sup max min".split())
 
-    _dropsub_symbols = set(r'''\int \oint'''.split())
+    _dropsub_symbols = set(r'\int \oint \iint \oiint \iiint \oiiint \iiiint'.split())
 
     _fontnames = set("rm cal it tt sf bf bfit "
                      "default bb frak scr regular".split())

lib/matplotlib/_mathtext_data.py

@@ -795,6 +795,7 @@
     'eth'                      : 240,
     'colon'                    : 58,
     'sqcup'                    : 8852,
+    'bigsqcup'                 : 10758,
     'rightrightarrows'         : 8649,
     'sqsupset'                 : 8848,
     'mapsto'                   : 8614,
@@ -1078,7 +1079,8 @@
     'varniobar'                : 8957,
     'niobar'                   : 8958,
     'bagmember'                : 8959,
-    'triangle'                 : 9651
+    'triangle'                 : 9651,
+    'iiiint'                   : 10764,
 }
 
 # Each element is a 4-tuple of the form: