[latexrefman-commits] [SCM] latexrefman updated: r843 - trunk
karl at gnu.org.ua
karl at gnu.org.ua
Thu Nov 26 18:24:21 CET 2020
Author: karl
Date: 2020-11-26 19:24:21 +0200 (Thu, 26 Nov 2020)
New Revision: 843
Modified:
trunk/ChangeLog
trunk/latex2e.texi
Log:
math spacing commands can now be used in text mode
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-11-24 19:05:53 UTC (rev 842)
+++ trunk/ChangeLog 2020-11-26 17:24:21 UTC (rev 843)
@@ -1,3 +1,20 @@
+2020-11-26 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (Spacing in math mode),
+ (\thinspace & \negthinspace): all math spacing commands
+ can be used in text as of 2020-10-01 release, or with amsmath.
+ Following ltnews32.
+ Suggestion from Pablo Gonzalez L, 24 Nov 2020.
+
+2020-11-25 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (@LaTeX{} command syntax): mention xparse and expl3.
+ Suggestion from Pablo Gonzalez L, 23 Oct 2020 00:54:51.
+
+ (Overview): mention first-packages document.
+ (\@@startsection) <subsubsection>: use @raggedright since the text
+ does not format well, and no rewrite is plausible.
+
2020-11-24 Karl Berry <karl at freefriends.org>
* latex2e.texi: omit mention of textcomp, since it has become a no-op.
@@ -4,7 +21,7 @@
(picture): mention use of arithmetic expressions;
move qbezier example to qbezier node.
(\DeclareGraphicsExtensions): pdf before png; mention grfext.
- These suggestions from Pablo Gonzalez L, 23 Oct 2020.
+ These suggestions from Pablo Gonzalez L, 23 Oct 2020 22:02:33.
2020-09-17 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-11-24 19:05:53 UTC (rev 842)
+++ trunk/latex2e.texi 2020-11-26 17:24:21 UTC (rev 843)
@@ -14,10 +14,10 @@
@c
@c xx ctan, distributions, components of TeX
@c xx classes and packages -- required, additional, useful; oberdiek; fonts
- at c
@c xx merge permuted-index
@c xx merge latex-manual from savannah
@c xx merge display style math
+ at c xx check recent ltnews for (lots of) changes
@c xx \write of non-ASCII chars (vincent mail of 14 Mar 2020 21:39:41)
@c xx \nonstopmode etc., if they are officially supported by LaTeX?
@c xx JH explain nfss somewhere
@@ -208,18 +208,18 @@
@cindex unofficial nature of this manual
@cindex @LaTeX{} Project team
@findex @email{@value{LTXREFMAN_BUGS}} @r{email address}
- at LaTeX{} is currently maintained by a group of volunteers
-(@url{http://latex-project.org}). The official documentation written by
-the @LaTeX{} project is available from their web site. This document is
-completely unofficial and has not been reviewed by the @LaTeX{}
-maintainers.
+ at LaTeX{} is maintained by a small group of volunteers
+(@url{http://latex-project.org}). The official documentation written
+by the @LaTeX{} project is available from their web site. The present
+document is completely unofficial and has not been reviewed by the
+ at LaTeX{} maintainers.
@cindex bug reporting
@cindex reporting bugs
Do not send bug reports or anything else about this document to them.
Instead, please send all comments to @email{@value{LTXREFMAN_BUGS}}.
-This document is a reference. There is a vast array of other sources
-of information about @LaTeX{}, at all levels. Here are a few
+This document is a reference. There is a vast array of other
+information about @LaTeX{}, at all levels. Here are a few
introductions.
@table @url
@@ -231,6 +231,10 @@
@findex first-latex-doc @r{document}
Writing your first document, with a bit of both text and math.
+ at item http://ctan.org/pkg/first-packages
+ at findex first-packages @r{document}
+Recommendations for @LaTeX{} packages for basic needs.
+
@item http://ctan.org/pkg/usrguide
@findex usrguide @r{official documentation}
The guide for document authors that is maintained as part of @LaTeX{}.
@@ -543,6 +547,14 @@
This manual describes all accepted options and @code{*}-forms for the
commands it covers (barring unintentional omissions, a.k.a.@: bugs).
+ at PkgIndex{expl3}
+ at PkgIndex{xparse}
+ at cindex @LaTeX{}3 syntax
+As of the 2020-10-01 release of @LaTeX{}, the @code{expl3} and
+ at code{xparse} packages are part of the @LaTeX{}2e format. They
+provide a completely different underlying programming language
+syntax. We won't try to cover them in this document; see the related
+package documentation and other @LaTeX{} manuals.
@node Environment
@section Environment
@@ -3269,7 +3281,7 @@
* \subsubsection & \paragraph & \subparagraph:: Lower divisions.
* \appendix:: Start appendices.
* \frontmatter & \mainmatter & \backmatter:: The three parts of a book.
-* \@@startsection:: Typesetting sectional unit headings.
+* \@@startsection:: Sectional unit headings.
@end menu
@@ -4008,10 +4020,12 @@
@code{\normalfont\large\bfseries}.
@item
+ at raggedright
For @code{subsubsection}: @var{level} is 3, @var{indent} is 0 at dmn{pt},
@var{beforeskip} is @code{-3.25ex plus -1ex minus -0.2ex},
@var{afterskip} is @code{1.5ex plus 0.2ex}, and @var{style} is
@code{\normalfont\normalsize\bfseries}.
+ at end raggedright
@end itemize
Some examples follow. These go either in a package or class file or in the
@@ -5628,14 +5642,14 @@
is @code{0pt}.
@item \parsep
- at anchor{list parsep}
-Vertical space between paragraphs within an item. The defaults for the first three levels in
- at LaTeX{}'s @samp{article}, @samp{book}, and @samp{report} classes at 10
-point size are: @code{4pt plus2pt minus1pt}, @code{2pt plus1pt
-minus1pt}, and @code{0pt}. The defaults at 11 point size are:
- at code{4.5pt plus2pt minus1pt}, @code{2pt plus1pt minus1pt}, and
- at code{0pt}. The defaults at 12 point size are: @code{5pt plus2.5pt
-minus1pt}, @code{2.5pt plus1pt minus1pt}, and @code{0pt}.
+ at anchor{list parsep} Vertical space between paragraphs within an item.
+The defaults for the first three levels in @LaTeX{}'s @samp{article},
+ at samp{book}, and @samp{report} classes at 10 point size are: @code{4pt
+plus2pt minus1pt}, @code{2pt plus1pt minus1pt}, and @code{0pt}. The
+defaults at 11 point size are: @code{4.5pt plus2pt minus1pt},
+ at code{2pt plus1pt minus1pt}, and @code{0pt}. The defaults at 12 point
+size are: @code{5pt plus2.5pt minus1pt}, @code{2.5pt plus1pt
+minus1pt}, and @code{0pt}.
@item \partopsep
@anchor{list partopsep}
@@ -9425,11 +9439,13 @@
@PkgIndex{suffix}
@PkgIndex{xparse}
-There are two sometimes more convenient ways to accomplish the work of
- at code{\@@ifstar}. The @file{suffix} package allows the construct
- at code{\newcommand\mycommand@{@var{unstarred-variant}@}} followed by
- at code{\WithSuffix\newcommand\mycommand*@{@var{starred-variant}@}}. And
- at LaTeX{}3 has the @file{xparse} package that allows this code.
+There are two alternative ways to accomplish the work of
+ at code{\@@ifstar}. (1)@tie{}The @file{suffix} package allows the
+construct @code{\newcommand\mycommand@{@var{unstarred-variant}@}}
+followed by
+ at code{\WithSuffix\newcommand\mycommand*@{@var{starred-variant}@}}.
+(2)@tie{}@LaTeX{} provides the @file{xparse} package, which allows
+this code:
@example
\NewDocumentCommand\foo@{s@}@{\IfBooleanTF#1
@@ -13344,9 +13360,9 @@
@LaTeX{} ignores the space and in the output the m is next to the x,
as @math{y=mx}.
-But @LaTeX{}'s rules sometimes need tweaking. For example, in an
+But @LaTeX{}'s rules occasionally need tweaking. For example, in an
integral the tradition is to put a small extra space between the
- at code{f(x)} and the @code{dx}, here done with the @code{\,} command.
+ at code{f(x)} and the @code{dx}, here done with the @code{\,} command:
@example
\int_0^1 f(x)\,dx
@@ -13364,9 +13380,16 @@
@findex \;
@findex \thickspace
@anchor{spacing in math mode thickspace}
-Synonym: @code{\thickspace}. Normally @code{5.0mu plus 5.0mu}. Math
-mode only.
+Synonym: @code{\thickspace}. Normally @code{5.0mu plus 5.0mu}.
+With @code{amsmath}, or as of the 2020-10-01 @LaTeX{} release, can be
+used in text mode as well as math mode; before that, in math mode only.
+ at item \negthickspace
+ at findex \negthickspace
+Normally @code{-5.0mu plus 2.0mu minus 4.0mu}.
+With @code{amsmath}, or as of the 2020-10-01 @LaTeX{} release, can be
+used in text mode as well as math mode; before that, in math mode only.
+
@item \:
@itemx \>
@findex \:
@@ -13374,8 +13397,15 @@
@findex \medspace
@anchor{spacing in math mode medspace}
Synonym: @code{\medspace}. Normally @code{4.0mu plus 2.0mu minus 4.0mu}.
-Math mode only.
+With @code{amsmath}, or as of the 2020-10-01 @LaTeX{} release, can be
+used in text mode as well as math mode; before that, in math mode only.
+ at item \negmedspace
+ at findex \negmedspace
+Normally @code{-4.0mu plus 2.0mu minus 4.0mu}.
+With @code{amsmath}, or as of the 2020-10-01 @LaTeX{} release, can be
+used in text mode as well as math mode; before that, in math mode only.
+
@item \,
@findex \,
@findex \thinspace
@@ -13402,9 +13432,11 @@
@findex \negthinspace
@cindex thin space, negative
@anchor{spacing in math mode negthinspace}
-A negative thin space. Normally @code{-3mu}. The @code{\!} command is
-math mode only but the @code{\negthinspace} command is available for
-text mode (@pxref{\thinspace & \negthinspace}).
+A negative thin space. Normally @code{-3mu}.
+With @code{amsmath}, or as of the 2020-10-01 @LaTeX{} release, can be
+used in text mode as well as math mode; before that,
+The @code{\!} command is math mode only but the @code{\negthinspace}
+command has always worked in text mode (@pxref{\thinspace & \negthinspace}).
@item \quad
@cindex quad
@@ -13423,8 +13455,8 @@
@end table
@menu
-* \smash:: Eliminate height or depth of a subformula.
-* \phantom & \vphantom & \hphantom:: Make empty box with the same size as the argument.
+* \smash:: Eliminate height or depth of a subformula.
+* \phantom & \vphantom & \hphantom:: Make empty box same size as argument.
@end menu
@@ -14700,15 +14732,15 @@
\negthinspace
@end example
-Produce an unbreakable and unstretchable space of 1/6 at dmn{em} and
--1/6 at dmn{em}. These are the text mode equivalents of @code{\,} and
- at code{\!} (@pxref{Spacing in math mode/\thinspace}). You can use
- at code{\,} as a synonym for @code{\thinspace} in text mode.
+These produce unbreakable and unstretchable spaces of 1/6 at dmn{em} and
+-1/6 at dmn{em}, respectively. These are the text mode equivalents of
+ at code{\,} and @code{\!} (@pxref{Spacing in math mode/\thinspace}).
-The @code{\negthinspace} command is used in text mode mostly for
-fiddling with spaces. One common use of @code{\thinspace} is as the
-space between nested quotes.
+You can use @code{\,} as a synonym for @code{\thinspace} in text mode.
+One common use of @code{\thinspace} is as the space between nested
+quotes:
+
@example
Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
@end example
@@ -14716,9 +14748,15 @@
@noindent
Another use is that some style guides call for a @code{\thinspace}
between an ellipsis and a sentence ending period (other style guides,
-though, think the three dots are quite enough already). Still another
-use is between initials, as in @code{D.\thinspace E.\ Knuth}.
+think the three dots and/or four dots are plenty). Another
+style-specific use is between initials, as in @code{D.\thinspace E.\
+Knuth}.
+ at LaTeX{} provides a variety of similar spacing commands
+(@pxref{Spacing in math mode}). With @code{amsmath}, or as of the
+2020-10-01 @LaTeX{} release, they can be used in text mode as well as
+math mode, including @code{\!} for @code{\negthinspace}; before that,
+they were available only in math mode.
@node \/
@section @code{\/}
More information about the latexrefman-commits
mailing list.