[latexrefman-commits] [SCM] latexrefman updated: r919 - trunk

jimhefferon at gnu.org.ua jimhefferon at gnu.org.ua
Sun May 30 23:28:13 CEST 2021


Author: jimhefferon
Date: 2021-05-30 21:28:12 +0000 (Sun, 30 May 2021)
New Revision: 919

Modified:
   trunk/ChangeLog
   trunk/latex2e.html
   trunk/latex2e.info
   trunk/latex2e.pdf
   trunk/latex2e.texi
Log:
Add section for \mathstrut

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2021-05-29 11:29:32 UTC (rev 918)
+++ trunk/ChangeLog	2021-05-30 21:28:12 UTC (rev 919)
@@ -1,5 +1,10 @@
 2021-05-29  Jim Hefferon  <jim at joshua.smcvt.edu>
 
+	* latex2e.texi (\mathstrut): Add section for \mathstrut; adjust section
+	  for \vphantom to use an example not best done with \mathstrut.
+
+2021-05-29  Jim Hefferon  <jim at joshua.smcvt.edu>
+
 	* latex2e.texi (HTML head): Adopt HTML head from easyurls for .texi.
 
 2021-05-28  Karl Berry  <karl at freefriends.org>

Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html	2021-05-29 11:29:32 UTC (rev 918)
+++ trunk/latex2e.html	2021-05-30 21:28:12 UTC (rev 919)
@@ -420,6 +420,7 @@
     <ul class="no-bullet">
       <li><a id="toc-_005csmash-1" href="#g_t_005csmash">16.6.1 <code>\smash</code></a></li>
       <li><a id="toc-_005cphantom-_0026-_005cvphantom-_0026-_005chphantom-1" href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">16.6.2 <code>\phantom</code> & <code>\vphantom</code> & <code>\hphantom</code></a></li>
+      <li><a id="toc-_005cmathstrut-1" href="#g_t_005cmathstrut">16.6.3 <code>\mathstrut</code></a></li>
     </ul></li>
     <li><a id="toc-Math-miscellany-1" href="#Math-miscellany">16.7 Math miscellany</a>
     <ul class="no-bullet">
@@ -15886,6 +15887,8 @@
 </td></tr>
 <tr><td align="left" valign="top">• <a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom" accesskey="2">\phantom & \vphantom & \hphantom</a></td><td>  </td><td align="left" valign="top">Make empty box same size as argument.
 </td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005cmathstrut" accesskey="3">\mathstrut</a></td><td>  </td><td align="left" valign="top">Add some vertical space to a formula.
+</td></tr>
 </table>
 
 
@@ -15973,7 +15976,7 @@
 <hr>
 <span id="g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom"></span><div class="header">
 <p>
-Previous: <a href="#g_t_005csmash" accesskey="p" rel="prev">\smash</a>, Up: <a href="#Spacing-in-math-mode" accesskey="u" rel="up">Spacing in math mode</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cmathstrut" accesskey="n" rel="next">\mathstrut</a>, Previous: <a href="#g_t_005csmash" accesskey="p" rel="prev">\smash</a>, Up: <a href="#Spacing-in-math-mode" accesskey="u" rel="up">Spacing in math mode</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <span id="g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom-1"></span><h4 class="subsection">16.6.2 <code>\phantom</code> & <code>\vphantom</code> & <code>\hphantom</code></h4>
 
@@ -16010,17 +16013,20 @@
 box with the same width as <var>subformula</var> but with height and depth
 zero.
 </p>
-<p>Without the <code>\vphantom</code> in this example, the top bars of the two
-square roots would be at different heights.
+<p>In this example, in the summand expression on the left the tower of
+exponents is so tall that TeX places this expression further down
+than its default.  Without adjustment, that would have the two summand
+expressions at different levels.  The <code>\phantom</code> in the expression
+on the left tells TeX to leave as much vertical room as it does for
+the ‘<samp>3^{3^{3^j}}}</samp>’, so the two expressions come out at the
+same level.
 </p>
 <div class="example">
-<pre class="example">\( \sqrt{\vphantom{a^3}a}\cdot\sqrt{a^3} \)
+<pre class="example">\begin{displaymath}
+    \sum_{j\in\{0,\ldots\, 10\}\phantom{3^{3^{3^j}}}} \sum_{i\in\{0,\ldots\, 3^{3^{3^j}}\}} i\cdot j
+\end{displaymath}
 </pre></div>
 
-<p>The <code>\vphantom{a^3}</code> causes the first <code>\sqrt</code> to have inside
-it a box of the same height as the second <code>\sqrt</code>, so LaTeX
-makes the bars align.
-</p>
 <p>These commands often are combined with <code>\smash</code>.  See <a href="#g_t_005csmash">\smash</a>,
 for another example of the use of <code>\vphantom</code>.
 </p>
@@ -16050,6 +16056,42 @@
 </p>
 
 <hr>
+<span id="g_t_005cmathstrut"></span><div class="header">
+<p>
+Previous: <a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom" accesskey="p" rel="prev">\phantom & \vphantom & \hphantom</a>, Up: <a href="#Spacing-in-math-mode" accesskey="u" rel="up">Spacing in math mode</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="g_t_005cmathstrut-1"></span><h4 class="subsection">16.6.3 <code>\mathstrut</code></h4>
+
+<span id="index-_005cmathstrut"></span>
+<span id="index-spacing_002c-math-mode-1"></span>
+<span id="index-vertical-spacing-1"></span>
+<span id="index-math-mode_002c-spacing-2"></span>
+<span id="index-invisible-character-1"></span>
+<span id="index-character_002c-invisible-1"></span>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\mathstrut
+</pre></div>
+
+<p>The analogue of <code>\strut</code> for mathematics.  See <a href="#g_t_005cstrut">\strut</a>.
+</p>
+<p>The input <code>$\sqrt{x} + \sqrt{x^i}$</code> gives output where the
+second radical is taller than the first, which is ugly.  To add extra
+vertical space without any horizontal space, so that the two have the
+same height, use <code>$\sqrt{x\mathstrut} + \sqrt{x^i\mathstrut}$</code>.
+</p>
+<p>The <code>\mathstrut</code> command adds the vertical height of an open
+parenthesis, <code>(</code>, but no horizontal space.  In fact, it is defined
+as <code>\vphantom{(}</code>. (See <a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a>.)
+An advantage over <code>\strut</code> is that <code>\mathstrut</code> adds no depth,
+which is often the right thing for formulas.  Using the height of an
+open parenthesis is just a convention; for complete control over the
+amount of space, use <code>\rule</code> with a width of zero.  See <a href="#g_t_005crule">\rule</a>.
+</p>
+
+<hr>
 <span id="Math-miscellany"></span><div class="header">
 <p>
 Previous: <a href="#Spacing-in-math-mode" accesskey="p" rel="prev">Spacing in math mode</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
@@ -24835,6 +24877,7 @@
 <tr><td></td><td valign="top"><a href="#index-_005cmathsection"><code>\mathsection</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cmathsf"><code>\mathsf</code></a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cmathsterling"><code>\mathsterling</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmathstrut"><code><code>\mathstrut</code></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmathstrut">\mathstrut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cmathtt"><code>\mathtt</code></a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cmathunderscore"><code>\mathunderscore</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cmathversion"><code>\mathversion</code></a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
@@ -25485,6 +25528,7 @@
 <tr><td></td><td valign="top"><a href="#index-character-category-code">character category code</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-character-encoding">character encoding</a>:</td><td> </td><td valign="top"><a href="#inputenc-package">inputenc package</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-character_002c-invisible">character, invisible</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-character_002c-invisible-1">character, invisible</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmathstrut">\mathstrut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-characters_002c-accented">characters, accented</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-characters_002c-case-of">characters, case of</a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-characters_002c-non_002dEnglish">characters, non-English</a>:</td><td> </td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
@@ -25922,6 +25966,7 @@
 <tr><td></td><td valign="top"><a href="#index-insertions-of-special-characters">insertions of special characters</a>:</td><td> </td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-internal-vertical-mode">internal vertical mode</a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-invisible-character">invisible character</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-invisible-character-1">invisible character</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmathstrut">\mathstrut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-italic-correction">italic correction</a>:</td><td> </td><td valign="top"><a href="#g_t_005c_002f">\/</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-italic-font">italic font</a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-itemize-environment"><code><code>itemize</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#itemize">itemize</a></td></tr>
@@ -26065,6 +26110,7 @@
 <tr><td></td><td valign="top"><a href="#index-math-mode_002c-entering">math mode, entering</a>:</td><td> </td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-math-mode_002c-spacing">math mode, spacing</a>:</td><td> </td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-math-mode_002c-spacing-1">math mode, spacing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-mode_002c-spacing-2">math mode, spacing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmathstrut">\mathstrut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-math-mode_002c-vertical-space">math mode, vertical space</a>:</td><td> </td><td valign="top"><a href="#g_t_005csmash">\smash</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-math-symbols">math symbols</a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-math_002c-arrows"><code>math, arrows</code></a>:</td><td> </td><td valign="top"><a href="#Arrows">Arrows</a></td></tr>
@@ -26484,6 +26530,7 @@
 <tr><td></td><td valign="top"><a href="#index-spacing_002c-inter_002dsentence">spacing, inter-sentence</a>:</td><td> </td><td valign="top"><a href="#g_t_005cfrenchspacing">\frenchspacing</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-spacing_002c-inter_002dsentence-1">spacing, inter-sentence</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnormalsfcodes">\normalsfcodes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-spacing_002c-math-mode">spacing, math mode</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-spacing_002c-math-mode-1">spacing, math mode</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmathstrut">\mathstrut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-Spanish-ordinals_002c-feminine-and-masculine">Spanish ordinals, feminine and masculine</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-special-characters">special characters</a>:</td><td> </td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-special-characters-1">special characters</a>:</td><td> </td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
@@ -26650,6 +26697,7 @@
 <tr><td></td><td valign="top"><a href="#index-vertical-space-1">vertical space</a>:</td><td> </td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-vertical-space-before-paragraphs">vertical space before paragraphs</a>:</td><td> </td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent & \parskip</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-vertical-spacing">vertical spacing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-spacing-1">vertical spacing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmathstrut">\mathstrut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-vertical-spacing_002c-math-mode">vertical spacing, math mode</a>:</td><td> </td><td valign="top"><a href="#g_t_005csmash">\smash</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-visible-space">visible space</a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-visible-space-symbol_002c-in-text">visible space symbol, in text</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>

Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info	2021-05-29 11:29:32 UTC (rev 918)
+++ trunk/latex2e.info	2021-05-30 21:28:12 UTC (rev 919)
@@ -10840,6 +10840,7 @@
 
 * \smash::                           Eliminate height or depth of a subformula.
 * \phantom & \vphantom & \hphantom:: Make empty box same size as argument.
+* \mathstrut::                       Add some vertical space to a formula.
 
 
 File: latex2e.info,  Node: \smash,  Next: \phantom & \vphantom & \hphantom,  Up: Spacing in math mode
@@ -10905,7 +10906,7 @@
 over smashing a subformula box.
 
 
-File: latex2e.info,  Node: \phantom & \vphantom & \hphantom,  Prev: \smash,  Up: Spacing in math mode
+File: latex2e.info,  Node: \phantom & \vphantom & \hphantom,  Next: \mathstrut,  Prev: \smash,  Up: Spacing in math mode
 
 16.6.2 '\phantom' & '\vphantom' & '\hphantom'
 ---------------------------------------------
@@ -10929,14 +10930,17 @@
 has width zero.  And '\hphantom' makes a box with the same width as
 SUBFORMULA but with height and depth zero.
 
-   Without the '\vphantom' in this example, the top bars of the two
-square roots would be at different heights.
+   In this example, in the summand expression on the left the tower of
+exponents is so tall that TeX places this expression further down than
+its default.  Without adjustment, that would have the two summand
+expressions at different levels.  The '\phantom' in the expression on
+the left tells TeX to leave as much vertical room as it does for the
+'3^{3^{3^j}}}', so the two expressions come out at the same level.
 
-     \( \sqrt{\vphantom{a^3}a}\cdot\sqrt{a^3} \)
+     \begin{displaymath}
+         \sum_{j\in\{0,\ldots\, 10\}\phantom{3^{3^{3^j}}}} \sum_{i\in\{0,\ldots\, 3^{3^{3^j}}\}} i\cdot j
+     \end{displaymath}
 
-   The '\vphantom{a^3}' causes the first '\sqrt' to have inside it a box
-of the same height as the second '\sqrt', so LaTeX makes the bars align.
-
    These commands often are combined with '\smash'.  *Note \smash::, for
 another example of the use of '\vphantom'.
 
@@ -10959,6 +10963,31 @@
 with '\leavevmode'.
 
 
+File: latex2e.info,  Node: \mathstrut,  Prev: \phantom & \vphantom & \hphantom,  Up: Spacing in math mode
+
+16.6.3 '\mathstrut'
+-------------------
+
+Synopsis:
+
+     \mathstrut
+
+   The analogue of '\strut' for mathematics.  *Note \strut::.
+
+   The input '$\sqrt{x} + \sqrt{x^i}$' gives output where the second
+radical is taller than the first, which is ugly.  To add extra vertical
+space without any horizontal space, so that the two have the same
+height, use '$\sqrt{x\mathstrut} + \sqrt{x^i\mathstrut}$'.
+
+   The '\mathstrut' command adds the vertical height of an open
+parenthesis, '(', but no horizontal space.  In fact, it is defined as
+'\vphantom{(}'.  (*Note \phantom & \vphantom & \hphantom::.)  An
+advantage over '\strut' is that '\mathstrut' adds no depth, which is
+often the right thing for formulas.  Using the height of an open
+parenthesis is just a convention; for complete control over the amount
+of space, use '\rule' with a width of zero.  *Note \rule::.
+
+
 File: latex2e.info,  Node: Math miscellany,  Prev: Spacing in math mode,  Up: Math formulas
 
 16.7 Math miscellany
@@ -17445,6 +17474,7 @@
 * \mathsection:                          Math symbols.        (line 878)
 * \mathsf:                               Font styles.         (line 114)
 * \mathsterling:                         Math symbols.        (line 881)
+* \mathstrut:                            \mathstrut.          (line   6)
 * \mathtt:                               Font styles.         (line 117)
 * \mathunderscore:                       Math symbols.        (line 884)
 * \mathversion:                          Font styles.         (line 129)
@@ -18070,7 +18100,7 @@
 * amsmath package <8>:                   Dots.                (line  36)
 * amsmath package <9>:                   Math functions.      (line 111)
 * amsmath package <10>:                  \phantom & \vphantom & \hphantom.
-                                                              (line  44)
+                                                              (line  47)
 * amsmath package <11>:                  Colon character & \colon.
                                                               (line  15)
 * amsmath package <12>:                  Colon character & \colon.
@@ -18208,6 +18238,7 @@
 * character encoding:                    inputenc package.    (line  13)
 * character, invisible:                  \phantom & \vphantom & \hphantom.
                                                               (line   6)
+* character, invisible <1>:              \mathstrut.          (line   6)
 * characters, accented:                  Accents.             (line   6)
 * characters, case of:                   Upper and lower case.
                                                               (line   6)
@@ -18720,6 +18751,7 @@
 * internal vertical mode:                Modes.               (line  38)
 * invisible character:                   \phantom & \vphantom & \hphantom.
                                                               (line   6)
+* invisible character <1>:               \mathstrut.          (line   6)
 * italic correction:                     \/.                  (line   6)
 * italic font:                           Font styles.         (line  82)
 * itemize environment:                   itemize.             (line   6)
@@ -18875,6 +18907,7 @@
                                                               (line   6)
 * math mode, spacing <1>:                \phantom & \vphantom & \hphantom.
                                                               (line   6)
+* math mode, spacing <2>:                \mathstrut.          (line   6)
 * math mode, vertical space:             \smash.              (line   6)
 * math symbols:                          Math symbols.        (line   6)
 * math, arrows:                          Arrows.              (line   6)
@@ -18886,7 +18919,7 @@
                                                               (line  45)
 * mathtools package <4>:                 \smash.              (line  61)
 * mathtools package <5>:                 \phantom & \vphantom & \hphantom.
-                                                              (line  36)
+                                                              (line  39)
 * MetaPost package:                      \line.               (line  36)
 * mfirstuc package:                      Upper and lower case.
                                                               (line  46)
@@ -19015,7 +19048,7 @@
 * package, amsmath <8>:                  Dots.                (line  36)
 * package, amsmath <9>:                  Math functions.      (line 111)
 * package, amsmath <10>:                 \phantom & \vphantom & \hphantom.
-                                                              (line  44)
+                                                              (line  47)
 * package, amsmath <11>:                 Colon character & \colon.
                                                               (line  15)
 * package, amsmath <12>:                 Colon character & \colon.
@@ -19101,7 +19134,7 @@
                                                               (line  45)
 * package, mathtools <4>:                \smash.              (line  61)
 * package, mathtools <5>:                \phantom & \vphantom & \hphantom.
-                                                              (line  36)
+                                                              (line  39)
 * package, MetaPost:                     \line.               (line  36)
 * package, mfirstuc:                     Upper and lower case.
                                                               (line  46)
@@ -19370,6 +19403,7 @@
 * spacing, inter-sentence <1>:           \normalsfcodes.      (line   6)
 * spacing, math mode:                    \phantom & \vphantom & \hphantom.
                                                               (line   6)
+* spacing, math mode <1>:                \mathstrut.          (line   6)
 * Spanish ordinals, feminine and masculine: Text symbols.     (line 167)
 * special characters:                    Reserved characters. (line   6)
 * special characters <1>:                Additional Latin letters.
@@ -19561,6 +19595,7 @@
                                                               (line   6)
 * vertical spacing:                      \phantom & \vphantom & \hphantom.
                                                               (line   6)
+* vertical spacing <1>:                  \mathstrut.          (line   6)
 * vertical spacing, math mode:           \smash.              (line   6)
 * visible space:                         \verb.               (line  31)
 * visible space symbol, in text:         Text symbols.        (line 213)
@@ -19924,205 +19959,206 @@
 Ref: spacing in math mode negthinspace396428
 Ref: spacing in math mode quad396755
 Ref: spacing in math mode qquad397011
-Node: \smash397274
-Node: \phantom & \vphantom & \hphantom399491
-Node: Math miscellany401529
-Node: Colon character & \colon402035
-Node: \*402728
-Node: \frac403308
-Node: \sqrt403679
-Node: \stackrel404265
-Node: Modes404538
-Ref: modes paragraph mode404988
-Ref: modes lr mode405184
-Ref: modes math mode405790
-Ref: modes vertical mode406125
-Ref: modes internal vertical mode406296
-Ref: modes inner paragraph mode406769
-Ref: modes outer paragraph mode406769
-Node: \ensuremath407183
-Node: Page styles407888
-Node: \maketitle408651
-Node: \pagenumbering411669
-Node: \pagestyle413657
-Node: \thispagestyle417159
-Node: Spaces418113
-Node: \enspace & \quad & \qquad419554
-Node: \hspace420469
-Node: \hfill422307
-Node: \hss423371
-Node: \spacefactor424065
-Node: \@427452
-Ref: \AT427552
-Node: \frenchspacing429492
-Node: \normalsfcodes430327
-Node: \(SPACE)430574
-Node: ~432364
-Node: \thinspace & \negthinspace434941
-Node: \/436112
-Node: \hrulefill & \dotfill438068
-Node: \bigskip & \medskip & \smallskip439424
-Ref: bigskip440242
-Ref: medskip440446
-Ref: smallskip440655
-Node: \bigbreak & \medbreak & \smallbreak441316
-Node: \strut442302
-Node: \vspace445497
-Node: \vfill447061
-Node: \addvspace447989
-Node: Boxes449985
-Node: \mbox & \makebox450691
-Ref: mbox makebox depth451959
-Ref: mbox makebox height451959
-Ref: mbox makebox width451959
-Ref: mbox makebox totalheight451959
-Node: \fbox & \framebox454054
-Ref: fbox framebox fboxrule455368
-Ref: fbox framebox fboxsep455558
-Node: \parbox456648
-Node: \raisebox458954
-Ref: raisebox depth459927
-Ref: raisebox height459927
-Ref: raisebox width459927
-Ref: raisebox totalheight459927
-Node: \sbox & \savebox460628
-Node: lrbox463690
-Node: \usebox464576
-Node: Color465015
-Node: Color package options465814
-Node: Color models467460
-Ref: color models cmyk468257
-Ref: color models gray468620
-Ref: color models rgb468769
-Ref: color models RGB469106
-Ref: color models named469481
-Node: Commands for color469769
-Node: Define colors470184
-Node: Colored text470909
-Node: Colored boxes473306
-Node: Colored pages474695
-Node: Graphics475388
-Node: Graphics package options477515
-Node: Graphics package configuration480268
-Node: \graphicspath481070
-Node: \DeclareGraphicsExtensions484028
-Node: \DeclareGraphicsRule485846
-Node: Commands for graphics489027
-Node: \includegraphics489532
-Ref: includegraphics width494586
-Ref: includegraphics height495119
-Ref: includegraphics totalheight495525
-Ref: includegraphics keepaspectratio495789
-Ref: includegraphics viewport497475
-Ref: includegraphics trim497870
-Ref: includegraphics clip498326
-Ref: includegraphics page498586
-Ref: includegraphics pagebox498677
-Ref: includegraphics interpolate499542
-Ref: includegraphics quiet499747
-Ref: includegraphics draft499908
-Ref: includegraphics bb500713
-Ref: includegraphics bbllx501111
-Ref: includegraphics bblly501111
-Ref: includegraphics bburx501111
-Ref: includegraphics bbury501111
-Ref: includegraphics natwidth501253
-Ref: includegraphics natheight501253
-Ref: includegraphics hiresbb501439
-Ref: includegraphics type502201
-Ref: includegraphics ext502241
-Ref: includegraphics read502344
-Ref: includegraphics command502461
-Node: \rotatebox502707
-Node: \scalebox505561
-Node: \resizebox506617
-Node: Special insertions507809
-Node: Reserved characters508677
-Node: Upper and lower case509937
-Node: Symbols by font position512323
-Node: Text symbols513002
-Node: Accents517986
-Node: \accent520139
-Node: Additional Latin letters521901
-Ref: Non-English characters522083
-Node: inputenc package523102
-Node: \rule525531
-Node: \today526696
-Node: Splitting the input527632
-Node: \endinput529374
-Node: \include & \includeonly530677
-Node: \input534974
-Node: Front/back matter536189
-Node: Table of contents etc.536522
-Node: \addcontentsline540347
-Node: \addtocontents543189
-Node: \nofiles544780
-Node: Indexes545512
-Node: \index547120
-Node: makeindex552225
-Ref: makeindex preamble553893
-Ref: makeindex postamble554033
-Ref: makeindex group skip554118
-Ref: makeindex letheadflag554451
-Ref: makeindex lethead prefix554912
-Ref: makeindex lethead suffix555064
-Ref: makeindex item 0555212
-Ref: makeindex item 1555292
-Ref: makeindex item 2555367
-Ref: makeindex item 01555445
-Ref: makeindex item x1555550
-Ref: makeindex item 12555755
-Ref: makeindex item x2555863
-Ref: makeindex delim 0556023
-Ref: makeindex delim 1556153
-Ref: makeindex delim 2556283
-Ref: makeindex delim n556409
-Ref: makeindex delim r556544
-Ref: makeindex line max556652
-Ref: makeindex indent space556787
-Ref: makeindex indent length556882
-Ref: makeindex page precedence557067
-Node: \printindex557941
-Node: Glossaries558414
-Node: \newglossaryentry560381
-Node: \gls561848
-Node: Letters562642
-Node: \address566260
-Node: \cc567071
-Node: \closing567513
-Node: \encl567827
-Node: \location568241
-Node: \makelabels568505
-Node: \name570822
-Node: \opening571063
-Node: \ps571344
-Node: \signature571633
-Node: \telephone572861
-Node: Input/output573226
-Node: \openin & \openout573956
-Node: \read576699
-Node: \typein577886
-Node: \typeout579146
-Node: \write580196
-Node: \write and security584923
-Node: \message585867
-Node: \wlog587696
-Node: \write18588197
-Node: Command line interface591688
-Ref: Command line591852
-Node: Command line options593935
-Ref: interaction modes594931
-Ref: output directory595885
-Node: Command line input597584
-Node: Jobname599413
-Node: Recovering from errors602694
-Node: Document templates604039
-Node: beamer template604473
-Node: article template605115
-Node: book template605578
-Node: Larger book template606057
-Node: Index607599
-Ref: Command Index607685
+Node: \smash397349
+Node: \phantom & \vphantom & \hphantom399566
+Node: \mathstrut401883
+Node: Math miscellany402856
+Node: Colon character & \colon403362
+Node: \*404055
+Node: \frac404635
+Node: \sqrt405006
+Node: \stackrel405592
+Node: Modes405865
+Ref: modes paragraph mode406315
+Ref: modes lr mode406511
+Ref: modes math mode407117
+Ref: modes vertical mode407452
+Ref: modes internal vertical mode407623
+Ref: modes inner paragraph mode408096
+Ref: modes outer paragraph mode408096
+Node: \ensuremath408510
+Node: Page styles409215
+Node: \maketitle409978
+Node: \pagenumbering412996
+Node: \pagestyle414984
+Node: \thispagestyle418486
+Node: Spaces419440
+Node: \enspace & \quad & \qquad420881
+Node: \hspace421796
+Node: \hfill423634
+Node: \hss424698
+Node: \spacefactor425392
+Node: \@428779
+Ref: \AT428879
+Node: \frenchspacing430819
+Node: \normalsfcodes431654
+Node: \(SPACE)431901
+Node: ~433691
+Node: \thinspace & \negthinspace436268
+Node: \/437439
+Node: \hrulefill & \dotfill439395
+Node: \bigskip & \medskip & \smallskip440751
+Ref: bigskip441569
+Ref: medskip441773
+Ref: smallskip441982
+Node: \bigbreak & \medbreak & \smallbreak442643
+Node: \strut443629
+Node: \vspace446824
+Node: \vfill448388
+Node: \addvspace449316
+Node: Boxes451312
+Node: \mbox & \makebox452018
+Ref: mbox makebox depth453286
+Ref: mbox makebox height453286
+Ref: mbox makebox width453286
+Ref: mbox makebox totalheight453286
+Node: \fbox & \framebox455381
+Ref: fbox framebox fboxrule456695
+Ref: fbox framebox fboxsep456885
+Node: \parbox457975
+Node: \raisebox460281
+Ref: raisebox depth461254
+Ref: raisebox height461254
+Ref: raisebox width461254
+Ref: raisebox totalheight461254
+Node: \sbox & \savebox461955
+Node: lrbox465017
+Node: \usebox465903
+Node: Color466342
+Node: Color package options467141
+Node: Color models468787
+Ref: color models cmyk469584
+Ref: color models gray469947
+Ref: color models rgb470096
+Ref: color models RGB470433
+Ref: color models named470808
+Node: Commands for color471096
+Node: Define colors471511
+Node: Colored text472236
+Node: Colored boxes474633
+Node: Colored pages476022
+Node: Graphics476715
+Node: Graphics package options478842
+Node: Graphics package configuration481595
+Node: \graphicspath482397
+Node: \DeclareGraphicsExtensions485355
+Node: \DeclareGraphicsRule487173
+Node: Commands for graphics490354
+Node: \includegraphics490859
+Ref: includegraphics width495913
+Ref: includegraphics height496446
+Ref: includegraphics totalheight496852
+Ref: includegraphics keepaspectratio497116
+Ref: includegraphics viewport498802
+Ref: includegraphics trim499197
+Ref: includegraphics clip499653
+Ref: includegraphics page499913
+Ref: includegraphics pagebox500004
+Ref: includegraphics interpolate500869
+Ref: includegraphics quiet501074
+Ref: includegraphics draft501235
+Ref: includegraphics bb502040
+Ref: includegraphics bbllx502438
+Ref: includegraphics bblly502438
+Ref: includegraphics bburx502438
+Ref: includegraphics bbury502438
+Ref: includegraphics natwidth502580
+Ref: includegraphics natheight502580
+Ref: includegraphics hiresbb502766
+Ref: includegraphics type503528
+Ref: includegraphics ext503568
+Ref: includegraphics read503671
+Ref: includegraphics command503788
+Node: \rotatebox504034
+Node: \scalebox506888
+Node: \resizebox507944
+Node: Special insertions509136
+Node: Reserved characters510004
+Node: Upper and lower case511264
+Node: Symbols by font position513650
+Node: Text symbols514329
+Node: Accents519313
+Node: \accent521466
+Node: Additional Latin letters523228
+Ref: Non-English characters523410
+Node: inputenc package524429
+Node: \rule526858
+Node: \today528023
+Node: Splitting the input528959
+Node: \endinput530701
+Node: \include & \includeonly532004
+Node: \input536301
+Node: Front/back matter537516
+Node: Table of contents etc.537849
+Node: \addcontentsline541674
+Node: \addtocontents544516
+Node: \nofiles546107
+Node: Indexes546839
+Node: \index548447
+Node: makeindex553552
+Ref: makeindex preamble555220
+Ref: makeindex postamble555360
+Ref: makeindex group skip555445
+Ref: makeindex letheadflag555778
+Ref: makeindex lethead prefix556239
+Ref: makeindex lethead suffix556391
+Ref: makeindex item 0556539
+Ref: makeindex item 1556619
+Ref: makeindex item 2556694
+Ref: makeindex item 01556772
+Ref: makeindex item x1556877
+Ref: makeindex item 12557082
+Ref: makeindex item x2557190
+Ref: makeindex delim 0557350
+Ref: makeindex delim 1557480
+Ref: makeindex delim 2557610
+Ref: makeindex delim n557736
+Ref: makeindex delim r557871
+Ref: makeindex line max557979
+Ref: makeindex indent space558114
+Ref: makeindex indent length558209
+Ref: makeindex page precedence558394
+Node: \printindex559268
+Node: Glossaries559741
+Node: \newglossaryentry561708
+Node: \gls563175
+Node: Letters563969
+Node: \address567587
+Node: \cc568398
+Node: \closing568840
+Node: \encl569154
+Node: \location569568
+Node: \makelabels569832
+Node: \name572149
+Node: \opening572390
+Node: \ps572671
+Node: \signature572960
+Node: \telephone574188
+Node: Input/output574553
+Node: \openin & \openout575283
+Node: \read578026
+Node: \typein579213
+Node: \typeout580473
+Node: \write581523
+Node: \write and security586250
+Node: \message587194
+Node: \wlog589023
+Node: \write18589524
+Node: Command line interface593015
+Ref: Command line593179
+Node: Command line options595262
+Ref: interaction modes596258
+Ref: output directory597212
+Node: Command line input598911
+Node: Jobname600740
+Node: Recovering from errors604021
+Node: Document templates605366
+Node: beamer template605800
+Node: article template606442
+Node: book template606905
+Node: Larger book template607384
+Node: Index608926
+Ref: Command Index609012
 
 End Tag Table
 

Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2021-05-29 11:29:32 UTC (rev 918)
+++ trunk/latex2e.texi	2021-05-30 21:28:12 UTC (rev 919)
@@ -13681,6 +13681,7 @@
 @menu
 * \smash::                           Eliminate height or depth of a subformula.
 * \phantom & \vphantom & \hphantom:: Make empty box same size as argument.
+* \mathstrut::                       Add some vertical space to a formula.
 @end menu
 
 
@@ -13796,17 +13797,20 @@
 box with the same width as @var{subformula} but with height and depth
 zero.
 
-Without the @code{\vphantom} in this example, the top bars of the two
-square roots would be at different heights.
+In this example, in the summand expression on the left the tower of
+exponents is so tall that @TeX{} places this expression further down
+than its default.  Without adjustment, that would have the two summand
+expressions at different levels.  The @code{\phantom} in the expression
+on the left tells @TeX{} to leave as much vertical room as it does for
+the @samp{3^@{3^@{3^j@}@}@}}, so the two expressions come out at the
+same level.
 
 @example
-\( \sqrt@{\vphantom@{a^3@}a@}\cdot\sqrt@{a^3@} \)
+\begin@{displaymath@}
+    \sum_@{j\in\@{0,\ldots\, 10\@}\phantom@{3^@{3^@{3^j@}@}@}@} \sum_@{i\in\@{0,\ldots\, 3^@{3^@{3^j@}@}\@}@} i\cdot j
+\end@{displaymath@}
 @end example
 
-The @code{\vphantom@{a^3@}} causes the first @code{\sqrt} to have inside
-it a box of the same height as the second @code{\sqrt}, so @LaTeX{}
-makes the bars align.
-
 These commands often are combined with @code{\smash}.  @xref{\smash},
 for another example of the use of @code{\vphantom}.
 
@@ -13831,6 +13835,38 @@
 with @code{\leavevmode}.
 
 
+ at node \mathstrut
+ at subsection @code{\mathstrut}
+
+ at findex @code{\mathstrut}
+ at cindex spacing, math mode
+ at cindex vertical spacing
+ at cindex math mode, spacing
+ at cindex invisible character
+ at cindex character, invisible
+
+Synopsis:
+
+ at example
+\mathstrut
+ at end example
+
+The analogue of @code{\strut} for mathematics.  @xref{\strut}.
+
+The input @code{$\sqrt@{x@} + \sqrt@{x^i@}$} gives output where the
+second radical is taller than the first, which is ugly.  To add extra
+vertical space without any horizontal space, so that the two have the
+same height, use @code{$\sqrt@{x\mathstrut@} + \sqrt@{x^i\mathstrut@}$}.
+
+The @code{\mathstrut} command adds the vertical height of an open
+parenthesis, @code{(}, but no horizontal space.  In fact, it is defined
+as @code{\vphantom@{(@}}. (@xref{ \phantom & \vphantom & \hphantom}.)
+An advantage over @code{\strut} is that @code{\mathstrut} adds no depth,
+which is often the right thing for formulas.  Using the height of an
+open parenthesis is just a convention; for complete control over the
+amount of space, use @code{\rule} with a width of zero.  @xref{\rule}.
+
+
 @node Math miscellany
 @section Math miscellany
 



More information about the latexrefman-commits mailing list.