[latexrefman-commits] [SCM] latexrefman updated: r1110 - trunk
Vincent Bela?che
INVALID.NOREPLY at gnu.org.ua
Sun Aug 21 23:06:33 CEST 2022
Author: vincentb1
Date: 2022-08-21 21:06:33 +0000 (Sun, 21 Aug 2022)
New Revision: 1110
Modified:
trunk/latex2e.texi
Log:
[en] twoside -> twocolumn, and other fixes found while propagating r641, r643, & r644.
* latex2e.texi (Font styles, tabular)
(\bigskip & \medskip & \smallskip): Add anchors.
(Font styles): Comment for asking English natives to improve some
wording.
(\flushbottom): ``documents'' -> ``document'' --- confirmed by Jim.
(\raggedbottom): ``twoside'' -> ``twocolumn'' --- confirmed by Karl.
(\appendix, tabular, Control sequences, Making paragraphs)
(Math functions, Over- and Underlining, \sqrt, \pagenumbering)
(\bigbreak & \medbreak & \smallbreak): Improve wording.
(abstract): Fix @PkgIndex call.
(tabular): fix => ``|'' does not remove \tabcolsep.
(Control sequences): ``sequences'' -> ``the stream'' --- confirmed by Karl.
(Subscripts & superscripts): Clarify why ``\(3^3^3\)''
fails. ``parenthesis'' -> ``curly braces''. ``error'' -> ``TeX error''.
(\left & \right): @dfn{...}-ize ``null delimiter''.
(Math functions): Fix @math{...} display. Typo --- Infimum. Fix extra @iftex.
(\stackrel): suppress useless ``one of''.
(\pagenumbering): Clarify how \pagenumbering is global.
(\bigskip & \medskip & \smallskip): Add @findex.
(Accents): Fix @ref-erence.
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2022-08-14 20:22:47 UTC (rev 1109)
+++ trunk/latex2e.texi 2022-08-21 21:06:33 UTC (rev 1110)
@@ -2104,6 +2104,8 @@
you can get bold sans serif by saying either of
@code{\sffamily\bfseries} or @code{\bfseries\sffamily}.
+ at anchor{\nocorrlist}
+ at anchor{\nocorr}
@findex \nocorrlist
@findex \nocorr
One advantage of these commands is that they automatically insert italic
@@ -2230,8 +2232,13 @@
The following commands are for use in math mode. They are not
cumulative, so @code{\mathbf@{\mathit@{@var{symbol}@}@}} does not
create a boldface and italic @var{symbol}; instead, it will just be in
-italics. This is because typically math symbols need consistent
-typographic treatment, regardless of the surrounding environment.
+italics. @c xx TODO, improve wording of the sequel to be more down to
+ at c earth, do not use words consistent or environment. See French version
+ at c ``C'est ainsi car typiquement les symboles mathématiques ont besoin
+ at c d'être toujours traités typographiquement de la même manière,
+ at c indépendamment de ce qui les entoure''
+This is because typically math symbols need consistent typographic
+treatment, regardless of the surrounding environment.
@table @code
@item \mathrm
@@ -2264,6 +2271,7 @@
@end table
+ at anchor{\mathversion}
@findex \mathversion
@cindex math, bold
@cindex bold math
@@ -2271,6 +2279,7 @@
switching to bold letters and symbols in
formulas. @code{\mathversion@{normal@}} restores the default.
+ at anchor{\oldstylenums}
@findex \oldstylenums
@cindex numerals, old-style
@cindex old-style numerals
@@ -2778,7 +2787,7 @@
@findex \flushbottom
-Make all pages in the documents after this declaration have the same
+Make all pages in the document after this declaration have the same
height, by stretching the vertical space where necessary to fill out the
page. This is most often used when making two-sided documents since the
differences in facing pages can be glaring.
@@ -2809,7 +2818,7 @@
document the facing pages may be different heights. This command can go
at any point in the document body. @xref{\flushbottom}.
-This is the default unless you select the @code{twoside} document class
+This is the default unless you select the @code{twocolumn} document class
option (@pxref{Document class options}).
@@ -4023,12 +4032,12 @@
\appendix
@end example
-This does not directly produce any output. But in a book or report it
-declares that subsequent @code{\chapter} commands start an appendix. In
-an article it does the same, for @code{\section} commands. It also
-resets the @code{chapter} and @code{section} counters to at tie{}0 in a
-book or report, and in an article resets the @code{section} and
- at code{subsection} counters.
+This does not directly produce any output. But in a @code{book} or
+ at code{report} document it declares that subsequent @code{\chapter}
+commands start an appendix. In an article it does the same, for
+ at code{\section} commands. It also resets the @code{chapter} and
+ at code{section} counters to at tie{}0 in a book or report, and in an article
+resets the @code{section} and @code{subsection} counters.
In this book
@@ -4733,9 +4742,9 @@
\end@{abstract@}
@end example
- at PkgIndex abstract
+ at PkgIndex{abstract}
The next example produces a one column abstract in a two column document (for
-a more flexible solution, use the package @file{abstract}).
+a more flexible solution, use the package @package{abstract}).
@c Adopted from http://www.tex.ac.uk/FAQ-onecolabs.html
@example
@@ -7598,14 +7607,14 @@
or space} material is typeset in LR mode. This text is fragile
(@pxref{\protect}).
-If between two columns there is no @@-expression then @LaTeX{}'s
- at code{book}, @code{article}, and @code{report} classes will put on
-either side of each column a space of length @code{\tabcolsep}, which by
-default is 6 at dmn{pt}. That is, by default adjacent columns are
+If between two column specifiers there is no @@-expression then
+ at LaTeX{}'s @code{book}, @code{article}, and @code{report} classes will
+put on either side of each column a space of width @code{\tabcolsep},
+which by default is 6 at dmn{pt}. That is, by default adjacent columns are
separated by 12 at dmn{pt} (so @code{\tabcolsep} is misleadingly named
since it is only half of the separation between tabular columns). In
-addition, a space of 6 at dmn{pt} also comes before the first column and
-after the final column, unless you put a @code{@@@{...@}} or @code{|}
+addition, a space of @code{\tabcolsep} also comes before the first
+column and after the final column, unless you put a @code{@@@{...@}}
there.
If you override the default and use an @@-expression then @LaTeX{} does
@@ -7635,6 +7644,7 @@
\end@{tabular@}
@end example
+ at anchor{\extracolsep}
@findex \extracolsep
An @code{\extracolsep@{@var{wd}@}} command in an @@-expression causes an
extra space of width @var{wd} to appear to the left of all subsequent
@@ -9831,10 +9841,10 @@
@cindex control sequences
-When reading input @TeX{} converts sequences of read characters into a
-sequence of @dfn{tokens}. When @TeX{} sees a backslash @code{\}, it
-will handle the following characters in a special way in order to make
-a @dfn{control sequence} token.
+When reading input @TeX{} converts the stream of read characters into a
+sequence of @dfn{tokens}. When @TeX{} sees a backslash @code{\}, it will
+handle the following characters in a special way in order to make a
+ at dfn{control sequence} token.
The control sequences fall into two categories:
@@ -9861,7 +9871,7 @@
Just as the @code{\relax} command does nothing, the following input
will simply print @samp{Hello!} @inlinefmt{tex,We use visible
spaces @samp{@visiblespace{}} instead of blanks}@inlinefmt{info, (if
-you use the Emacs info viewer at comma{} turn on the whitespace-mode
+you use the Emacs info viewer at comma{} turn on the @code{whitespace-mode}
minor mode to see the trailing spaces)}:
@example
@@ -11702,12 +11712,12 @@
``have you heard that Netherfield Park is let at last?''
@end example
-A paragraph separator is made of a sequence of at least one blank
-line, at least one of which is not terminated by a comment. A blank
-line is a line that is empty or made only of blank characters such as
-space or tab. Comments in source code are started with a @code{%} and
-span up to the end of line. In the following example the two columns
-are identical:
+A paragraph separator can be made of a sequence of at least one blank
+line, at least one of which is not terminated by a comment. A blank line
+is a line that is empty or made only of blank characters such as space
+or tab. Comments in source code are started with a @code{%} and span up
+to the end of line. In the following example the two columns are
+identical:
@example
\documentclass[twocolumn]@{article@}
@@ -12173,8 +12183,9 @@
subscript on a subscript, or supers on subs, or subs on supers. So,
expressions such as @code{e^@{x^2@}} and @code{x_@{i_0@}} give correct
output. Note the use in those expressions of curly braces to give the
- at var{base} a determined @var{exp}. If you enter @code{\(3^3^3\)} then
-you get @samp{Double superscript}.
+ at var{base} a determined @var{exp}. If you enter @code{\(3^3^3\)}, this
+interpreted as @code{\(3^@{3@}^@{3@}\)} and then you get @TeX{} error
+ at samp{Double superscript}.
@LaTeX{} does the right thing when something has both a subscript and a
superscript. In this example the integral has both. They come out in
@@ -12187,7 +12198,7 @@
@end example
@noindent
-Note the parentheses around @code{x=a} to make the entire expression a
+Note the curly braces around @code{x=a} to make the entire expression a
subscript.
To put a superscript or subscript before a symbol, use a construct like
@@ -12197,7 +12208,7 @@
Using the subscript or superscript character outside of math mode or
display math mode, as in @code{the expression x^2}, will get you
-the error @samp{Missing $ inserted}.
+the @TeX{} error @samp{Missing $ inserted}.
@PkgIndex{mhchem}
A common reason to want subscripts outside of a mathematics mode is to
@@ -13099,7 +13110,7 @@
Paragraph sign (pilcrow) in math mode, @BES{00B6,\P}.
@item \mathsection
-Section sign in math mode @BES{00A7,\S}.
+Section sign in math mode: @BES{00A7,\S}.
@item \mathsterling
Sterling sign in math mode: @pounds{}.
@@ -13450,7 +13461,7 @@
@PkgIndex{mathtools}
However, @var{delimiter1} and @var{delimiter2} need not match. A common
case is that you want an unmatched brace, as below. Use a period,
- at samp{.}, as a null delimiter.
+ at samp{.}, as a @dfn{null delimiter}.
@example
\begin@{equation@}
@@ -13858,7 +13869,7 @@
@item \bmod
Binary modulo operator, used as in @code{\( 5\bmod 3=2 \)}
@iftex
- at math{5 \bmod 3}
+ at math{5 \bmod 3 = 2}
@end iftex
@item \cos
@@ -13928,7 +13939,7 @@
@end iftex
@item \inf
-Infinum
+Infimum
@iftex
@math{\inf}
@end iftex
@@ -14018,7 +14029,6 @@
@end iftex
@item \sup
- at iftex
Supremum
@iftex
@math{\mathop {\rm sup}}
@@ -14045,13 +14055,14 @@
@end ftable
@PkgIndex{amsmath}
-The @package{amsmath} package adds improvements on some of these, and also
-allows you to define your own. The full documentation is on CTAN, but
-briefly, you can define an identity operator with
+The @package{amsmath} package adds improvements on some of these, and
+also allows you to define your own. The full documentation is on CTAN,
+but briefly, you can define an identity operator with
@code{\DeclareMathOperator@{\identity@}@{id@}} that is like the ones
above but prints as @samp{id}. The starred form
- at code{\DeclareMathOperator*@{\op@}@{op@}} sets any limits above and
-below, as is traditional with @code{\lim}, @code{\sup}, or @code{\max}.
+ at code{\DeclareMathOperator*@{\op@}@{op@}} sets any superscript or
+subscript to be above and below, as is traditional with @code{\lim},
+ at code{\sup}, or @code{\max}.
@node Math accents
@@ -14069,7 +14080,7 @@
@cindex acute accent, math
Math acute accent
@iftex
- at math{\acute{x}}.
+ at math{\acute{x}}
@end iftex
@item \bar
@@ -14207,8 +14218,8 @@
@ifset HAS-MATH
The result looks like this: @math{(1-\underbrace{1/2)+(1/2}-1/3)}.
@end ifset
-Attach text to the brace by using subscript, @code{_}, or superscript,
- at code{^}, as here.
+Attach text to the brace by using the subscript command, @code{_}, or
+superscript, @code{^}, as here.
@example
\begin@{displaymath@}
@@ -14659,7 +14670,7 @@
@end menu
- at node Colon character & \colon
+ at node Colon character & \colon
@subsection Colon character @code{:} & @code{\colon}
@anchor{colon}
@@ -14757,11 +14768,12 @@
@ifset HAS-MATH
It comes out like this: @math{\root 3 \of {x+y}}.
@end ifset
-The radical grows with the size of @var{arg} (as the height of the
-radical grows, the angle on the leftmost part gets steeper, until for
-a large enough @code{arg}, it is vertical).
+The size of the radical grows with that of @var{arg} (as the height of
+the radical grows, the angle on the leftmost part gets steeper, until
+for a tall enough @code{arg}, it is vertical).
- at LaTeX{} has a separate @code{\surd} character (@pxref{Math symbols}).
+ at LaTeX{} has a separate @code{\surd} symbol for making a square root
+without @var{arg} (@pxref{Math symbols}).
@node \stackrel
@@ -14771,7 +14783,7 @@
@cindex relation, text above
@findex \stackrel
-Synopsis, one of:
+Synopsis:
@example
\stackrel@{@var{text}@}@{@var{relation}@}
@@ -15028,11 +15040,13 @@
Specifies the style of page numbers, and resets the page number. The
numbering style is reflected on the page, and also in the table of
contents and other page references. This declaration has global scope
-so its effect is not delimited by braces or environments.
+so its effect is not stopped by an end of group such as a closing brace
+or an end of environment.
-In this example, before the Main section the pages are numbered
- at samp{a}, etc. Starting on the page containing that section, the pages
-are numbered @samp{1}, etc.
+In this example, before the @samp{Main} section the pages are numbered
+ at samp{a}, etc. Starting on the page containing the
+ at code{\pagenumbering} call in that section, the pages are numbered
+ at samp{1}, etc.
@example
\begin@{document@}\pagenumbering@{alph@}
@@ -15965,6 +15979,13 @@
@node \bigskip & \medskip & \smallskip
@section @code{\bigskip} & @code{\medskip} & @code{\smallskip}
+ at anchor{\bigskip}
+ at anchor{\medskip}
+ at anchor{\smallskip}
+ at findex \bigskip
+ at findex \medskip
+ at findex \smallskip
+
Synopsis, one of:
@example
@@ -16045,7 +16066,8 @@
Produce a vertical space that is big or medium-sized or small, and
suggest to @LaTeX{} that this is a good place to break the page. (The
-associated penalties are @minus{}200, @minus{}100, and @minus{}50.)
+associated penalties are respectively @minus{}200, @minus{}100, and
+ at minus{}50.)
@xref{\bigskip & \medskip & \smallskip}, for more. These commands
produce the same vertical space but differ in that they also remove a
@@ -18786,7 +18808,7 @@
@var{text}. The argument is always processed in LR mode
(@pxref{Modes}). The bar is always a fixed position under the baseline,
thus crossing through descenders. See also @code{\underline} in
- at ref{Math miscellany}.
+ at ref{Over- and Underlining}.
@item \c
@itemx \capitalcedilla
More information about the latexrefman-commits
mailing list.