``mathtext`` now supports ``\text``

``\text`` can be used to obtain upright text within an equation.

..plot::

:include-source: true

:alt: Illustration of the newly added\text command, showing that it renders as normal text, including spaces, despite being part of an equation. Also show that a dash is not rendered as a minus when part of a\text command.

import matplotlib.pyplot as plt

plt.text(0.1, 0.5, r"$a =\sin(\phi)\text{ such that }\phi =\frac{x}{y}$")

plt.text(0.1, 0.3, r"$\text{dashes (-) are retained}$")

p.optional_group=Forward()

p.sqrt=Forward()

p.subsuper=Forward()

p.text=Forward()

p.token=Forward()

p.underset=Forward()

r"\underset",

p.optional_group("annotation")+p.optional_group("body"))

p.text<<=cmd(r"\text",QuotedString('{','\\',endQuoteChar="}"))

p.placeable<<= (

p.accent# Must be before symbol as all accents are symbols

|p.symbol# Must be second to catch all named symbols and single

|p.underset

|p.sqrt

|p.overline

|p.text

)

p.simple<<= (

float_literal=staticmethod(pyparsing_common.convertToFloat)

deftext(self,s,loc,toks):

self.push_state()

state=self.get_state()

state.font='rm'

hlist=Hlist([Char(c,state)forcintoks[1]])

self.pop_state()

return [hlist]

def_make_space(self,percentage):

r'$x \overset{f}{\rightarrow} \overset{f}{x} \underset{xx}{ff} \overset{xx}{ff} \underset{f}{x} \underset{f}{\leftarrow} x$',# github issue #18241

r'$\sum x\quad\sum^nx\quad\sum_nx\quad\sum_n^nx\quad\prod x\quad\prod^nx\quad\prod_nx\quad\prod_n^nx$',# GitHub issue 18085

r'$1.$ $2.$ $19680801.$ $a.$ $b.$ $mpl.$',

r'$\text{text}_{\text{sub}}^{\text{sup}} + \text{\$foo\$} + \frac{\text{num}}{\mathbf{\text{den}}}\text{with space, curly brackets \{\}, and dash -}$',

]