Merge branch 'v4.1'

Author: dpvc

advanced/typeset.rst

@@ -108,14 +108,7 @@ in memory and a corresponding decrease in performance over time.
 
 To deal with changing content, MathJax provides a function that tells
 it to forget about math that it has previously typeset:
-
-.. js:function:: MathJax.typesetClear(elements)
-
-   :param HTMLElement[] elements: An optional array of HTML elements
-                                  whose typeset math is to be
-                                  forgotten.  If not given, all math
-                                  items are forgotten (i.e., the
-                                  entire list of items is removed).
+:js:meth:`MathJax.typesetClear()`.
 
 If you are removing a portion of your document that may include
 typeset mathematics, you should call this function **before** removing

input/tex/extensions/colorv2.rst

@@ -13,16 +13,16 @@ command, which is a switch that changes the color of everything that
 follows it.
 
 This extension is **not** loaded automatically when the `autoload`
-extension is used.  To load the `color` extension explicitly, add
+extension is used.  To load the `colorv2` extension explicitly, add
 ``'[tex]/colorv2'`` to the :data:`load` array of the :data:`loader`
-block of your MathJax configuration, and add ``'color'`` to the
+block of your MathJax configuration, and add ``'colorv2'`` to the
 :data:`packages` array of the :data:`tex` block.
 
 .. code-block:: javascript
 
    window.MathJax = {
      loader: {load: ['[tex]/colorv2']},
-     tex: {packages: {'[+]': ['color']}}
+     tex: {packages: {'[+]': ['colorv2']}}
    };
 
 or, use ``\require{colorv2}`` in a TeX expression to load it

input/tex/extensions/fontsizev3.rst

@@ -0,0 +1,43 @@
+.. _tex-fontsizev3:
+
+##########
+fontsizev3
+##########
+
+The `fontsizev3` extension (new in v4.1.2) re-defines the various
+font-sizing commands (like ``\tiny``, ``\small``, ``\large``, etc.) to
+be the sizes that they were in MathJax v3 and in v4 prior to v4.1.2,
+when they were corrected to be consistent with the sizes used in
+actual LaTeX.  This extension is intended for those sites that have
+legacy content where the old sizing values are critical to the layout.
+
+This extension is **not** loaded automatically when the `autoload`
+extension is used.  To load the `fontsizev3` extension explicitly, add
+``'[tex]/fontsizev3'`` to the :data:`load` array of the :data:`loader`
+block of your MathJax configuration, and add ``'fontsizev3'`` to the
+:data:`packages` array of the :data:`tex` block.
+
+.. code-block:: javascript
+
+   window.MathJax = {
+     loader: {load: ['[tex]/fontsizesv3']},
+     tex: {packages: {'[+]': ['fontsizesv3']}}
+   };
+
+or, use ``\require{fontsizesv3}`` in a TeX expression to load it
+dynamically from within the math on the page, if the
+:ref:`tex-require` extension is loaded.
+
+-----
+
+.. _tex-fontsizesv3-commands:
+
+fontsizesv3 Commands
+--------------------
+
+The `fontsizesv3` extension implements the following macros:
+``\Tiny``, ``\tiny``, ``\scriptsize``, ``\small``, ``\normalsize``,
+``\large``, ``\Large``, ``\LARGE``, ``\huge``, ``\Huge``
+
+
+|-----|

input/tex/extensions/index.rst

@@ -31,6 +31,7 @@ The main extensions are described below:
    empheq
    enclose
    extpfeil
+   fontsizev3
    gensymb
    html
    mathtools

input/tex/extensions/textmacros.rst

@@ -189,12 +189,18 @@ Size Control
 
 .. list-table::
 
+   * - ``\Tiny``
+     - tiny size
    * - ``\tiny``
      - very tiny size
-   * - ``\Tiny``
-     - tiny size (non-standard)
    * - ``\scriptsize``
      - size of super- and subscripts
+   * - ``\SMALL``
+     - same as script size
+   * - ``\footnotesize``
+     - size of footnotes
+   * - ``\Small``
+     - same as footnote size
    * - ``\small``
      - small size
    * - ``\normalsize``
@@ -208,7 +214,9 @@ Size Control
    * - ``\huge``
      - even larger size
    * - ``\Huge``
-     - largest size
+     - larger size yet
+   * - ``\HUGE``
+     - largest size (non-standard)
 
 
 Special Characters

input/tex/macros/index.rst

@@ -1141,6 +1141,8 @@ F
      -
    * - ``\flatfrac``
      - physics
+   * - ``\footnotesize``
+     - **base**, text-base
    * - ``\forall``
      -
    * - ``\frac``
@@ -1272,8 +1274,10 @@ H
    * - ``\hspace``
      - **base**, text-base
    * - ``\huge``
-     - **base**, text-base
+     - **base**, text-base, fontsizev3
    * - ``\Huge``
+     - **base**, text-base, fontsizev3
+   * - ``\HUGE``
      - **base**, text-base
    * - ``\hypcosecant``
      - physics
@@ -1880,7 +1884,7 @@ N
    * - ``\norm``
      - physics
    * - ``\normalsize``
-     - **base**, text-base
+     - **base**, text-base, fontsizev3
    * - ``\not``
      -
    * - ``\notag``
@@ -2306,7 +2310,7 @@ S
    * - ``\scriptscriptstyle``
      -
    * - ``\scriptsize``
-     - **base**, text-base
+     - **base**, text-base, fontsizev3
    * - ``\scriptstyle``
      -
    * - ``\searrow``
@@ -2364,6 +2368,10 @@ S
    * - ``\skew``
      -
    * - ``\small``
+     - **base**, text-base, fontsizev3
+   * - ``\Small``
+     - **base**, text-base
+   * - ``\SMALL``
      - **base**, text-base
    * - ``\smallfrown``
      - **ams**
@@ -2830,9 +2838,9 @@ T
    * - ``\times``
      -
    * - ``\tiny``
-     - **base**, text-base
+     - **base**, text-base, fontsizev3
    * - ``\Tiny``
-     - **base**, text-base
+     - **base**, text-base, fontsizev3
    * - ``\to``
      -
    * - ``\toggle``

requirements.txt

@@ -26,9 +26,9 @@ markupsafe==3.0.3
     # via jinja2
 packaging==25.0
     # via sphinx
-pygments==2.19.2
+pygments==2.20.0
     # via sphinx
-requests==2.32.5
+requests==2.33.0
     # via sphinx
 roman-numerals-py==3.1.0
     # via sphinx