[latexrefman-commits] [SCM] latexrefman updated: r855 - trunk
karl at gnu.org.ua
karl at gnu.org.ua
Wed Dec 9 19:13:04 CET 2020
Author: karl
Date: 2020-12-09 20:13:04 +0200 (Wed, 09 Dec 2020)
New Revision: 855
Modified:
trunk/ChangeLog
trunk/latex2e.texi
Log:
dash usage and examples
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-12-08 22:51:56 UTC (rev 854)
+++ trunk/ChangeLog 2020-12-09 18:13:04 UTC (rev 855)
@@ -1,3 +1,8 @@
+2020-12-09 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi: no spaces around em-dashes; this is American English.
+ Other dash-related tweaks.
+
2020-12-08 Karl Berry <karl at freefriends.org>
* latex2e.texi (Math symbols): \bigwedge and \bigvee were reversed;
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-12-08 22:51:56 UTC (rev 854)
+++ trunk/latex2e.texi 2020-12-09 18:13:04 UTC (rev 855)
@@ -13,7 +13,7 @@
@c xx read through latex2e news for things to update.
@c
@c xx ctan, distributions, components of TeX
- at c xx classes and packages -- required, additional, useful; oberdiek; fonts
+ at c xx classes and packages: required, additional, useful; oberdiek; fonts
@c xx merge permuted-index
@c xx merge latex-manual from savannah
@c xx merge display style math
@@ -4557,7 +4557,7 @@
\begin@{center@}
My father considered that anyone who went to chapel and didn't drink
alcohol was not to be tolerated.\\
- I grew up in that belief. --Richard Burton
+ I grew up in that belief. ---Richard Burton
\end@{center@}
@end example
@@ -6434,7 +6434,7 @@
Draw a line. It slopes such that it vertically rises @var{y_rise} for
every horizontal @var{x_run}. The @var{travel} is the total horizontal
-change at tie{}--- it is not the length of the vector, it is the change in
+change---it is not the length of the vector, it is the change in
@math{x}. In the special case of vertical lines, where
(@var{x_run}, at var{y_rise})=(0,1), the @var{travel} gives the change in
@math{y}.
@@ -6663,7 +6663,7 @@
Draw a line ending in an arrow. The slope of that line is: it
vertically rises @var{y_rise} for every horizontal @var{x_run}. The
- at var{travel} is the total horizontal change at tie{}--- it is not the
+ at var{travel} is the total horizontal change---it is not the
length of the vector, it is the change in @math{x}. In the special case
of vertical vectors, if (@var{x_run}, at var{y_rise})=(0,1), then
@var{travel} gives the change in @math{y}.
@@ -8012,13 +8012,13 @@
because the exclamation point is part of @code{literal-text}.
The single-character delimiter @var{char} surrounds
- at var{literal-text}@tie{}--- it must be the same character before and
-after. No spaces come between @code{\verb} or @code{\verb*} and
- at var{char}, or between @var{char} and @var{literal-text}, or between
- at var{literal-text} and the second occurrence of @var{char} (the synopsis
-shows a space only to distinguish one component from the other). The
-delimiter must not appear in @var{literal-text}. The @var{literal-text}
-cannot include a line break.
+ at var{literal-text}---it must be the same character before and after.
+No spaces come between @code{\verb} or @code{\verb*} and @var{char},
+or between @var{char} and @var{literal-text}, or between
+ at var{literal-text} and the second occurrence of @var{char} (the
+synopsis shows a space only to distinguish one component from the
+other). The delimiter must not appear in @var{literal-text}. The
+ at var{literal-text} cannot include a line break.
@cindex visible space
The @code{*}-form differs only in that spaces are printed with a visible
@@ -8027,10 +8027,10 @@
(Namely, {\tt\char`\ }.)
@end tex
-The output from this will include a character showing the spaces.
+The output from this will include a character showing spaces.
@example
-The commands's first argument is \verb*!filename with extension! and ...
+The command's first argument is \verb*!filename with extension! and ...
@end example
@PkgIndex{url}
@@ -8047,7 +8047,7 @@
You cannot use @code{\verb} in the argument to a macro, for instance in
the argument to a @code{\section}. It is not a question of @code{\verb}
being fragile (@pxref{\protect}), instead it just cannot appear there.
-(But the @code{cprotect} package can help with this.)
+However, the @code{cprotect} package can help with this.
@node verse
@@ -14670,28 +14670,36 @@
In addition, despite the period, @LaTeX{} does not use the
end-of-sentence spacing (@pxref{\@@}).
-Ties prevent the end of line separation of things where that could cause
-confusion. But they also reduce @LaTeX{}'s options when it breaks lines
-into paragraphs, so you can use too many. They are also matters of
-taste, sometimes alarmingly dogmatic taste, among readers. Nevertheless,
-here are some usage models, many of them from the @TeX{}book.
+Ties prevent the end of line separation of things where that could
+cause confusion. They also still allow hyphenation (of either of the
+tied words), so they are generally preferable to putting consecutive
+words in an @code{\mbox} (@pxref{\mbox & \makebox}).
+They are also matters of taste, sometimes alarmingly dogmatic taste,
+among readers. Nevertheless, here are some usage models, many of them
+from @cite{The @TeX{}book}.
+
@itemize @bullet
@item
Between an enumerator and its item, such as in references:
@code{Chapter~12}, or @code{Theorem~\ref@{th:Wilsons@}}, or
- at code{Figure~\ref@{fig:KGraph@}}. When cases are enumerated inline:
- at code{(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded}.
+ at code{Figure~\ref@{fig:KGraph@}}.
+ at item
+When cases are enumerated inline: @code{(b)~Show that $f(x)$ is
+(1)~continuous, and (2)~bounded}.
+
@PkgIndex{siunitx}
@item
Between a number and its unit: @code{$745.7.8$~watts} (the
@file{siunitx} package has a special facility for this) or
@code{144~eggs}. This includes between a month and a date:
- at code{October~12} or @code{12~Oct}. In general, in any expressions where
-numbers and abbreviations or symbols are separated by a space:
+ at code{October~12} or @code{12~Oct}. In general, in any expressions
+where numbers and abbreviations or symbols are separated by a space:
@code{AD~565}, or @code{2:50~pm}, or @code{Boeing~747}, or
- at code{268~Plains Road}, or @code{\$$1.4$~billion}.
+ at code{268~Plains Road}, or @code{\$$1.4$~billion}. Other common
+choices here are a thin space (@pxref{\thinspace & \negthinspace}) and
+no space at all.
@item
When mathematical phrases are rendered in words: @code{equals~$n$}, or
@@ -14708,15 +14716,12 @@
\ldots,~$n$}.
@item
-Between a person's forenames and between multiple surnames:
+Between a person's given names and between multiple surnames:
@code{Donald~E. Knuth}, or @code{Luis~I. Trabb~Pardo}, or
- at code{Charles~XII} (but you must give TeX places to break the line so
-you may do @code{Charles Louis Xavier~Joseph de~la Vall\'ee~Poussin}).
+ at code{Charles~XII}---but you must give @TeX{} places to break the line
+so you might do @code{Charles Louis Xavier~Joseph de~la
+Vall\'ee~Poussin}.
- at item
-Before a dash: @code{pages 12~--14} or @code{it is~--- it must be
-said~--- plausible}.
-
@end itemize
@@ -15235,7 +15240,7 @@
Now uncomment the second @code{\addvspace}. It does not make the gap
20 at dmn{pt} longer; instead the gap is the sum of @code{\baselineskip}
and 20 at dmn{pt}. So @code{\addvspace} in a sense does the opposite of
-its name --- it makes sure that multiple vertical spaces do not
+its name---it makes sure that multiple vertical spaces do not
accumulate, but instead that only the largest one is used.
@LaTeX{} uses this command to adjust the vertical space above or below
@@ -17258,13 +17263,14 @@
You can access any character of the current font using its number with
the @code{\symbol} command. For example, the visible space character
-used in the @code{\verb*} command has the code decimal 32, so it can be
-typed as @code{\symbol@{32@}}.
+used in the @code{\verb*} command has the code decimal 32 in the
+standard Computer Modern typewriter font, so it can be typed as
+ at code{\symbol@{32@}}.
You can also specify numbers in octal (base 8) by using a @code{'}
-prefix, or hexadecimal (base 16) with a @code{"} prefix, so the previous
-example could also be written as @code{\symbol@{'40@}} or
- at code{\symbol@{"20@}}.
+prefix, or hexadecimal (base 16) with a @code{"} prefix, so the
+visible space at 32 decimal could also be written as
+ at code{\symbol@{'40@}} or @code{\symbol@{"20@}}.
@node Text symbols
@@ -17445,19 +17451,22 @@
@item \textemdash @r{(or @code{---})}
@cindex em-dash
---- Em-dash (used for punctuation, as in
- at code{The playoffs --- if you are fortunate enough to make the playoffs ---
-is more like a sprint.}).
+ at raggedright
+--- Em-dash. Used for punctuation, usually similar to commas or
+parentheses, as in `@code{The playoffs---if you're lucky
+enough to make the playoffs---are more like a sprint.}' Conventions
+for spacing around em-dashes vary widely.
+ at end raggedright
@item \textendash @r{(or @code{--})}
@cindex e-dash
--- En-dash (used for ranges, as in @code{See pages 12--14}).
+-- En-dash. Used for ranges, as in `@code{see pages 12--14}'.
@item \texteuro
@cindex euro symbol
@cindex currency, euro
@PkgIndex{eurosym}
-The Euro symbol: @euro{}. For an alternative glyph design, try the
+The Euro currency symbol: @euro{}. For an alternative glyph design, try the
@file{eurosym} package; also, most fonts nowadays come with their own
Euro symbol (Unicode U+20AC).
@@ -19807,9 +19816,9 @@
input file in place of the @code{\typein} command.
In the second command version the optional argument @code{@var{cmd}}
-argument must be a command name --- it must begin with a backslash, \.
-This command name is then defined or redefined to be the input that you
-typed. For example, this
+argument must be a command name, that is, it must begin with a
+backslash, \. This command name is then defined or redefined to be
+the input that you typed. For example, this
@example
\typein[\student]@{Enter student name:@}
@@ -20756,7 +20765,7 @@
% % where |\T1\foo| is \emph{one} control sequence, not two!
\newcommand
-\def\ProvideTextCommand -- same with \providecommand
+\def\ProvideTextCommand % same with \providecommand
\@onlypreamble\DeclareTextCommand
\@onlypreamble\DeclareTextSymbol
\gdef\TextSymbolUnavailable#1{%
More information about the latexrefman-commits
mailing list.