summaryrefslogtreecommitdiff
path: root/docutils/test/functional
diff options
context:
space:
mode:
Diffstat (limited to 'docutils/test/functional')
-rw-r--r--docutils/test/functional/expected/math_output_mathml.html230
-rw-r--r--docutils/test/functional/input/data/comprehensive-math-test.txt200
2 files changed, 232 insertions, 198 deletions
diff --git a/docutils/test/functional/expected/math_output_mathml.html b/docutils/test/functional/expected/math_output_mathml.html
index 5cb03d5a1..d5f95a3bf 100644
--- a/docutils/test/functional/expected/math_output_mathml.html
+++ b/docutils/test/functional/expected/math_output_mathml.html
@@ -14,31 +14,27 @@
<p>Docutils supports inline math with the prefix or postfix <span class="docutils literal">:math:</span>
role specificator, <math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mi>n</mi><mo>!</mo><mo>+</mo><mi>sin</mi><mo>&ApplyFunction;</mo><mo stretchy="false">(</mo>
- <msubsup>
- <mi>x</mi><mi>n</mi><mn>2</mn>
- </msubsup>
- <mo stretchy="false">)</mo>
- </mrow>
+ <mi>n</mi><mo>!</mo><mo>+</mo><mi>sin</mi><mo>&ApplyFunction;</mo><mo stretchy="false">(</mo>
+ <msubsup>
+ <mi>x</mi><mi>n</mi><mn>2</mn>
+ </msubsup>
+ <mo stretchy="false">)</mo>
</math> and <math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <msub>
- <mi>A</mi><mtext>c</mtext>
- </msub>
- <mo>=</mo>
- <mfrac>
- <mrow>
- <mi>π</mi>
- </mrow>
- <mrow>
- <mn>4</mn>
- </mrow>
- </mfrac>
- <msup>
- <mi>d</mi><mn>2</mn>
- </msup>
- </mrow>
+ <msub>
+ <mi>A</mi><mtext>c</mtext>
+ </msub>
+ <mo>=</mo>
+ <mfrac>
+ <mrow>
+ <mi>π</mi>
+ </mrow>
+ <mrow>
+ <mn>4</mn>
+ </mrow>
+ </mfrac>
+ <msup>
+ <mi>d</mi><mn>2</mn>
+ </msup>
</math>, as well as displayed math via the
<cite>math</cite> directive:</p>
<div>
@@ -132,9 +128,7 @@ See <a class="reference internal" href="#eq-m">eq:M</a> and <a class="reference
</math>
</div>
<p>is <math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mo stretchy="false">|</mo><mi mathvariant="bold">M</mi><mo stretchy="false">|</mo><mo>=</mo><mi>a</mi><mi>d</mi><mo>-</mo><mi>b</mi><mi>c</mi>
- </mrow>
+ <mo stretchy="false">|</mo><mi mathvariant="bold">M</mi><mo stretchy="false">|</mo><mo>=</mo><mi>a</mi><mi>d</mi><mo>−</mo><mi>b</mi><mi>c</mi>
</math>.</p>
<p>More than one display math block can be put in one math directive.
For example, the following sum and integral with limits:</p>
@@ -220,9 +214,7 @@ directives:</p>
</math>
</div>
<p>with the <em>wave function</em> <math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mi class="capital-greek">Ψ</mi>
- </mrow>
+ <mi class="capital-greek">Ψ</mi>
</math>, describes how the quantum state of a
physical system changes in time.</p>
<dl>
@@ -235,127 +227,103 @@ physical system changes in time.</p>
</colgroup>
<tbody>
<tr><td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>a</mi>
- </mrow>
- <mo>´</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>a</mi>
+ </mrow>
+ <mo>´</mo>
+ </mover>
</math> <span class="docutils literal">\acute{a}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>t</mi>
- </mrow>
- <mo>˙</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>t</mi>
+ </mrow>
+ <mo>·</mo>
+ </mover>
</math> <span class="docutils literal">\dot{t}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>γ</mi>
- </mrow>
- <mo>^</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>γ</mi>
+ </mrow>
+ <mo>^</mo>
+ </mover>
</math> <span class="docutils literal"><span class="pre">\hat{\gamma}</span></span></p></td>
</tr>
<tr><td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>a</mi>
- </mrow>
- <mo>`</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>a</mi>
+ </mrow>
+ <mo>`</mo>
+ </mover>
</math> <span class="docutils literal">\grave{a}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>t</mi>
- </mrow>
- <mo>¨</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>t</mi>
+ </mrow>
+ <mo>··</mo>
+ </mover>
</math> <span class="docutils literal">\ddot{t}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>α</mi>
- </mrow>
- <mo>˜</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>α</mi>
+ </mrow>
+ <mo>∼</mo>
+ </mover>
</math> <span class="docutils literal"><span class="pre">\tilde{\alpha}</span></span></p></td>
</tr>
<tr><td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>x</mi>
- </mrow>
- <mo>˘</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>x</mi>
+ </mrow>
+ <mo>˘</mo>
+ </mover>
</math> <span class="docutils literal">\breve{x}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>t</mi>
- </mrow>
- <mo>⃛</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>t</mi>
+ </mrow>
+ <mo>···</mo>
+ </mover>
</math> <span class="docutils literal">\dddot{t}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>ı</mi>
- </mrow>
- <mo>⃗</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>ı</mi>
+ </mrow>
+ <mo>⃗</mo>
+ </mover>
</math> <span class="docutils literal"><span class="pre">\vec{\imath}</span></span></p></td>
</tr>
<tr><td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>a</mi>
- </mrow>
- <mo>ˇ</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>a</mi>
+ </mrow>
+ <mo>ˇ</mo>
+ </mover>
</math> <span class="docutils literal">\check{a}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>a</mi>
- </mrow>
- <mo>¯</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>a</mi>
+ </mrow>
+ <mo>-</mo>
+ </mover>
</math> <span class="docutils literal">\bar{a}</span></p></td>
<td><p><math xmlns="http://www.w3.org/1998/Math/MathML">
- <mrow>
- <mover>
- <mrow>
- <mi>R</mi>
- </mrow>
- <mo>⃗</mo>
- </mover>
- </mrow>
+ <mover>
+ <mrow>
+ <mi>R</mi>
+ </mrow>
+ <mo>⃗</mo>
+ </mover>
</math> <span class="docutils literal">\vec{R}</span></p></td>
</tr>
</tbody>
@@ -403,7 +371,7 @@ physical system changes in time.</p>
<munderover>
<mo>∫</mo>
<mrow>
- <mo>-</mo><mo>∞</mo>
+ <mo>−</mo><mo>∞</mo>
</mrow>
<mrow>
<mo>∞</mo>
@@ -432,7 +400,7 @@ physical system changes in time.</p>
<munderover>
<mo>∫</mo>
<mrow>
- <mo>-</mo><mo>∞</mo>
+ <mo>−</mo><mo>∞</mo>
</mrow>
<mrow>
<mo>∞</mo>
@@ -480,7 +448,7 @@ physical system changes in time.</p>
<msub>
<mi>s</mi><mi>δ</mi>
</msub>
- <mo stretchy="false">(</mo><mi>x</mi><mo>-</mo><mi>x</mi><mo>'</mo><mo stretchy="false">)</mo>
+ <mo stretchy="false">(</mo><mi>x</mi><mo>−</mo><mi>x</mi><mo>'</mo><mo stretchy="false">)</mo>
</mtd>
</mtr>
<mtr>
@@ -498,7 +466,7 @@ physical system changes in time.</p>
<msub>
<mi>s</mi><mi>δ</mi>
</msub>
- <mo stretchy="false">(</mo><mi>x</mi><mo>-</mo><mi>x</mi><mo>'</mo><mo stretchy="false">)</mo><mi mathvariant="normal">d</mi><mi>x</mi><mo>'</mo>
+ <mo stretchy="false">(</mo><mi>x</mi><mo>−</mo><mi>x</mi><mo>'</mo><mo stretchy="false">)</mo><mi mathvariant="normal">d</mi><mi>x</mi><mo>'</mo>
</mtd>
</mtr>
</mtable>
@@ -516,7 +484,7 @@ physical system changes in time.</p>
<mtable>
<mtr>
<mtd>
- <mo>-</mo><mn>1</mn>
+ <mo>−</mo><mn>1</mn>
</mtd>
<mtd>
<mi>x</mi><mo>&lt;</mo><mn>0</mn>
diff --git a/docutils/test/functional/input/data/comprehensive-math-test.txt b/docutils/test/functional/input/data/comprehensive-math-test.txt
index 4324709f1..a696789ef 100644
--- a/docutils/test/functional/input/data/comprehensive-math-test.txt
+++ b/docutils/test/functional/input/data/comprehensive-math-test.txt
@@ -136,23 +136,35 @@ Accents
.. class:: colwidths-auto
=========== ============= =========== ============= ============== ================
- `\acute{x}` ``\acute{x}`` `\dot{x}` ``\dot{x}`` `\hat{H}` ``\hat{H}``
- `\bar{v}` ``\bar{v}`` `\ddot{x}` ``\ddot{x}`` `\mathring{x}` ``\mathring{x}``
- `\breve{x}` ``\breve{x}`` `\dddot{x}` ``\dddot{x}`` `\tilde{n}` ``\tilde{n}``
- `\check{x}` ``\check{x}`` `\grave{x}` ``\grave{x}`` `\vec{R}` ``\vec{R}``
+ `\acute{x}` ``\acute{x}`` `\dot{t}` ``\dot{t}`` `\hat{H}` ``\hat{H}``
+ `\bar{v}` ``\bar{v}`` `\ddot{t}` ``\ddot{t}`` `\mathring{x}` ``\mathring{x}``
+ `\breve{x}` ``\breve{x}`` `\dddot{t}` ``\dddot{t}`` `\tilde{n}` ``\tilde{n}``
+ `\check{x}` ``\check{x}`` `\grave{x}` ``\grave{x}`` `\vec{x}` ``\vec{x}``
=========== ============= =========== ============= ============== ================
When adding an accent to an i or j in math, dotless variants can be
obtained with ``\imath`` and ``\jmath``: `\bar \imath`, `\hat{\jmath}`
+(MathML drops the dot automatically).
+
+For adornment that span multiple symbols, see `top and bottom
+embellishments`_.
+
+Font switches
+-------------
+
+TeX’s *math alphabets* correspond to the
+:t:`mathematical alphanumeric symbols` block in Unicode and the
+"mathvariant" `style attribute`__ in MathML. They are “to be used for
+mathematical variables where style variations are important
+semantically”.
+
+__ https://developer.mozilla.org/en-US/docs/Web/MathML/Attribute
-alphabets
----------
.. class:: colwidths-auto
=============== ============================ ==========================
command example result
=============== ============================ ==========================
- ``\boldsymbol`` ``\boldsymbol{\alpha + 3}`` `\boldsymbol{\alpha + 3}`
``\mathbf`` ``\mathbf{r}^2=x^2+y^2+z^2`` `\mathbf{r}^2=x^2+y^2+z^2`
``\mathbb`` ``\mathbb{R \subset C}`` `\mathbb{R \subset C}`
``\mathcal`` ``\mathcal{F}f(x)`` `\mathcal{F}f(x)`
@@ -160,14 +172,40 @@ alphabets
``\mathit`` ``\mathit{\Gamma}`` `\mathit{\Gamma}`
``\mathrm`` ``s_\mathrm{out}`` `s_\mathrm{out}`
``\mathsf`` ``\mathsf x`` `\mathsf x`
- ``\mathtt`` ``\mathtt{0.12}`` `\mathtt{0.12}`
+ ``\mathtt`` ``\mathtt{0.12}`` `\mathtt{0.12}`
=============== ============================ ==========================
-.. with isomath:
- 'mathbfit': 'bold-italic', # isomath
- 'mathsfit': 'sans-serif-italic', # isomath
- 'mathsfbfit': 'sans-serif-bold-italic', # isomath
- with mathrsfs, ... 'mathscr'
+Additional alphabets are defined in LaTeX packages, e.g.
+
+.. class:: colwidths-auto
+
+ =========== ============= ======================
+ TeX command LaTeX package MathML "mathvariant"
+ =========== ============= ======================
+ mathbfit isomath_ bold-italic
+ mathsfit isomath_ sans-serif-italic
+ mathsfbfit isomath_ sans-serif-bold-italic
+ mathscr mathrsfs_ script
+ =========== ============= ======================
+.. _isomath: https://www.ctan.org/pkg/isomath
+.. _mathrsfs: https://www.ctan.org/pkg/mathrsfs
+
+This can be used to typeset vector symbols in **bold** *italic*
+in line with the International Standard [ISO-80000-2].
+``\mathbfit{r}^2=x^2+y^2+z^2`` becomes
+
+.. math:: \mathbfit{r}^2=x^2+y^2+z^2.
+
+
+
+In contrast to the math alphabet selectors, ``\boldsymbol`` only changes
+the *font weight*. In LaTeX, it can be used to get a bold version of any
+mathematical symbol (for other output formats, results are mixed):
+
+.. math::
+ \boldsymbol{abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R}
+
+
Arrows
@@ -201,27 +239,26 @@ Binary operators
.. class:: colwidths-auto
================== ==================== ================= =================== ================== ====================
- `*` ``*`` `\circledast` ``\circledast`` `\odot` ``\odot``
- `+` ``+`` `\circledcirc` ``\circledcirc`` `\ominus` ``\ominus``
- `-` ``-`` `\circleddash` ``\circleddash`` `\oplus` ``\oplus``
- `:` ``:`` `\cup` ``\cup`` `\oslash` ``\oslash``
- `\Cap` ``\Cap`` `\curlyvee` ``\curlyvee`` `\otimes` ``\otimes``
- `\Cup` ``\Cup`` `\curlywedge` ``\curlywedge`` `\pm` ``\pm``
- `\amalg` ``\amalg`` `\dagger` ``\dagger`` `\rightthreetimes` ``\rightthreetimes``
- `\ast` ``\ast`` `\ddagger` ``\ddagger`` `\rtimes` ``\rtimes``
- `\bigcirc` ``\bigcirc`` `\diamond` ``\diamond`` `\setminus` ``\setminus``
- `\bigtriangledown` ``\bigtriangledown`` `\div` ``\div`` `\smallsetminus` ``\smallsetminus``
- `\bigtriangleup` ``\bigtriangleup`` `\divideontimes` ``\divideontimes`` `\sqcap` ``\sqcap``
- `\boxdot` ``\boxdot`` `\dotplus` ``\dotplus`` `\sqcup` ``\sqcup``
- `\boxminus` ``\boxminus`` `\doublebarwedge` ``\doublebarwedge`` `\star` ``\star``
- `\boxplus` ``\boxplus`` `\gtrdot` ``\gtrdot`` `\times` ``\times``
- `\boxtimes` ``\boxtimes`` `\intercal` ``\intercal`` `\triangleleft` ``\triangleleft``
- `\bullet` ``\bullet`` `\leftthreetimes` ``\leftthreetimes`` `\triangleright` ``\triangleright``
- `\cap` ``\cap`` `\lessdot` ``\lessdot`` `\uplus` ``\uplus``
- `\cdot` ``\cdot`` `\ltimes` ``\ltimes`` `\vee` ``\vee``
- `\centerdot` ``\centerdot`` `\mp` ``\mp`` `\veebar` ``\veebar``
- `\circ` ``\circ`` `\wedge` ``\wedge``
- .. `\wr` ``\wr``
+ `*` ``*`` `\circledast` ``\circledast`` `\ominus` ``\ominus``
+ `+` ``+`` `\circledcirc` ``\circledcirc`` `\oplus` ``\oplus``
+ `-` ``-`` `\circleddash` ``\circleddash`` `\oslash` ``\oslash``
+ `:` ``:`` `\cup` ``\cup`` `\otimes` ``\otimes``
+ `\Cap` ``\Cap`` `\curlyvee` ``\curlyvee`` `\pm` ``\pm``
+ `\Cup` ``\Cup`` `\curlywedge` ``\curlywedge`` `\rightthreetimes` ``\rightthreetimes``
+ `\amalg` ``\amalg`` `\dagger` ``\dagger`` `\rtimes` ``\rtimes``
+ `\ast` ``\ast`` `\ddagger` ``\ddagger`` `\setminus` ``\setminus``
+ `\bigcirc` ``\bigcirc`` `\diamond` ``\diamond`` `\smallsetminus` ``\smallsetminus``
+ `\bigtriangledown` ``\bigtriangledown`` `\div` ``\div`` `\sqcap` ``\sqcap``
+ `\bigtriangleup` ``\bigtriangleup`` `\divideontimes` ``\divideontimes`` `\sqcup` ``\sqcup``
+ `\boxdot` ``\boxdot`` `\dotplus` ``\dotplus`` `\star` ``\star``
+ `\boxminus` ``\boxminus`` `\doublebarwedge` ``\doublebarwedge`` `\times` ``\times``
+ `\boxplus` ``\boxplus`` `\gtrdot` ``\gtrdot`` `\triangleleft` ``\triangleleft``
+ `\boxtimes` ``\boxtimes`` `\intercal` ``\intercal`` `\triangleright` ``\triangleright``
+ `\bullet` ``\bullet`` `\leftthreetimes` ``\leftthreetimes`` `\uplus` ``\uplus``
+ `\cap` ``\cap`` `\lessdot` ``\lessdot`` `\vee` ``\vee``
+ `\cdot` ``\cdot`` `\ltimes` ``\ltimes`` `\veebar` ``\veebar``
+ `\centerdot` ``\centerdot`` `\mp` ``\mp`` `\wedge` ``\wedge``
+ `\circ` ``\circ`` `\odot` ``\odot`` `\wr` ``\wr``
================== ==================== ================= =================== ================== ====================
@@ -264,7 +301,7 @@ Letterlike symbols
`\mho` ``\mho`` `\complement` ``\complement`` `\gimel` ``\gimel`` `\hslash` ``\hslash``
`\Bbbk` ``\Bbbk`` `\Finv` ``\Finv`` `\daleth` ``\daleth`` `\imath` ``\imath``
`\ell` ``\ell`` `\Game` ``\Game`` `\nabla` ``\nabla`` `\partial` ``\partial``
-`\wp` ``\wp``
+`\wp` ``\wp``
======= ========== ============= =============== ========= =========== ========== ============
@@ -365,7 +402,18 @@ Use ``.`` for "empty" delimiters:
Top and bottom embellishments
-----------------------------
-TODO
+Visually similar to accents_ but generally applied to multiple symbols.
+
+.. class:: colwidths-auto
+
+ ========================== ============================ =========================== =============================
+ `\widetilde{abi}` ``\widetilde{abi}`` `\widehat{abi}` ``\widehat{abi}``
+ `\overline{abi}` ``\overline{abi}`` `\underline{abi}` ``\underline{abi}``
+ `\overbrace{abi}` ``\overbrace{abi}`` `\underbrace{abi}` ``\underbrace{abi}``
+ `\overleftarrow{abi}` ``\overleftarrow{abi}`` `\underleftarrow{abi}` ``\underleftarrow{abi}``
+ `\overrightarrow{abi}` ``\overrightarrow{abi}`` `\underrightarrow{abi}` ``\underrightarrow{abi}``
+ `\overleftrightarrow{abi}` ``\overleftrightarrow{abi}`` `\underleftrightarrow{abi}` ``\underleftrightarrow{abi}``
+ ========================== ============================ =========================== =============================
Extensible arrows
-----------------
@@ -416,47 +464,65 @@ internal LaTeX2MathML
* Shorthands for combined named operators
- =============== =================
- `\liminf` ``\liminf``
- `\limsup` ``\limsup``
- `\injlim` ``\injlim``
- `\projlim` ``\projlim``
- `\varinjlim` ``\varinjlim``
- `\varliminf` ``\varliminf``
- `\varlimsup` ``\varlimsup``
- `\varprojlim` ``\varprojlim``
- =============== =================
+ ========== ============ ============= =============== ==================
+ `\liminf` ``\liminf`` `\varliminf` ``\varliminf`` `\underline{\lim}`
+ `\limsup` ``\limsup`` `\varlimsup` ``\varlimsup`` `\overline{\lim}`
+ `\injlim` ``\injlim`` `varinjlim` ``\varinjlim``
+ `\projlim` ``\projlim`` `varprojlim` ``\varprojlim``
+ ========== ============ ============= =============== ==================
* Implement ``\circledS``? (in short-math-guide.pdf but not in mathematical Unicode characters)
- ``\widetilde{xxx}``
- ``\widehat{xxx}``
-
Tests
==========
+Font changes
+------------
-LICR macros in different alphabets:
+Math alphabet macros change the default alphabet ("mathvariant" in
+MathML), leaving some symbols unchanged:
-.. math::
+:normal: `abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R`
+:mathrm: `\mathrm{abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R}`
+:mathit: `\mathit{abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R}`
+:mathsf: `\mathsf{abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R}`
+:mathbb: `\mathbb{abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R}`
+:mathbf: `\mathbf{abs(x) \pm \alpha \approx 3 \Gamma \quad \forall x \in R`
- \text{normal: } &
- abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar \\
- \text{mathrm: } &
- \mathrm{abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar} \\
- \text{mathit: } &
- \mathit{abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar} \\
- \text{mathsf: } &
- \mathsf{abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar} \\
- \text{mathbb: } &
- \mathbb{abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar} \\
- \text{mathbf: } &
- \mathbf{abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar} \\
- \text{boldsymbol: } &
- \boldsymbol{abs(x) \pm \alpha \approx \Gamma \forall x \in R \bigstar}
-
-All blackboard-bold characters:
+Unicode supports the following blackboard-bold characters:
`\mathbb{a \ldots z A \ldots Z 0 \ldots 9
\mathbb\Gamma \mathbb{\Pi} \mathbb {\Sigma}\mathbb\gamma \mathbb\pi}`.
+The package mathrsfs_ (and some drop-in replacements) define the ``\mathscr``
+macro that selects a differently shaped "script" alphabet.
+Compare `\mathscr{A, B, …, Z, a, b, …, z}`
+with `\mathcal{A, B, …, Z, a, b, …, z}`.
+
+.. _rsfs: https://ctan.org/pkg/mathrsfs
+
+Inferred <mrow>s in MathML
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The elements <msqrt>, <mstyle>, <merror>, <mpadded>, <mphantom>, <menclose>,
+<mtd, mscarry>, and <math> treat their contents as a single inferred mrow
+formed from all their children.
+
+.. math:: a = \sqrt 2, b = \sqrt{1+x^2}, c = \sqrt\frac{sin(x)}{23}
+
+inline: :math:`a = \sqrt 2, b = \sqrt{1+x^2}, c = \sqrt\frac{sin(x)}{23}`.
+
+Accents vs. embellishments
+--------------------------
+
+MathML drops dots on "i" and "j" with accents:
+
+.. math:: \vec i \ne \overrightarrow i
+ \text{ and } \vec\lim \ne \overrightarrow\lim.
+
+Accents should be nearer to the base (in Firefox 78, it's vice versa!):
+
+.. math:: \vec a \vec l \ne \overrightarrow a \overrightarrow l
+
+ \bar a \bar l \ne \overline a \overline l
+