[latexrefman-commits] r340 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Tue May 19 14:39:32 2015
New Revision: 340

URL: http://svn.gna.org/viewcvs/latexrefman?rev=340&view=rev
Log:
Note that \mathxx commands do not nest

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=340&r1=339&r2=340&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Tue May 19 14:39:32 2015
@@ -1,3 +1,9 @@
+2015-05-19  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (Font styles): Add that \mathxx commands do not
+	nest.  Move them to make a different, third, area.  Break \emph out of
+	non-semantic command list.
+
 2015-05-17  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (many nodes): Corrections to typos reported by

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=340&r1=339&r2=340&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Tue May 19 14:39:32 2015
@@ -659,10 +659,11 @@
 The following type style commands are supported by @LaTeX{}.
 
 This first group of commands is typically used with an argument, as in
- at domain.hid text@}}.  In the table below, the corresponding
+ at code{\textit at domain.hid}@}}.  In the table below, the corresponding
 command in parenthesis is the ``declaration form'', which takes no
-arguments.  The scope of the declaration form lasts until the next type
-style command or the end of the current group.
+arguments, as in @code{@{\itshape @var{text}@}}.  The scope of the
+declaration form lasts until the next type style command or the end of
+the current group.
 
 These commands, in both the argument form and the declaration form,
 are cumulative; e.g., you can say either @code{\sffamily\bfseries} or
@@ -693,11 +694,6 @@
 @findex \itshape
 Italics.
 
- at domain.hid \emph
- at domain.hid \emph
- at domain.hid emphasis
-Emphasis (switches between @code{\textit} and @code{\textrm}).
-
 @item \textmd (\mdseries)
 @findex \textmd
 @findex \mdseries
@@ -738,6 +734,78 @@
 @findex \normalfont
 Main document font.
 
+ at end table
+
+ at cindex emphasis
+ at findex \emph
+The @code{\emph at domain.hid}@}} command is semantic, for text to be
+emphasized, and should not be used as a substitute for @code{\textit}.
+For example, @code{\emph at domain.hid text} \emph at domain.hid text}@}
+ at var{end text}@}} will result in the @var{start text} and @var{end text}
+in italics, but @var{middle text} will be in roman.
+
+ at LaTeX{} also provides the following commands, which unconditionally
+switch to the given style, that is, are @emph{not} cumulative.  Also,
+they are used differently than the above commands: @code{@{\@var{cmd}
+...@}} instead of @code{\@var{cmd}@{...@}}.  These are two unrelated
+constructs.
+
+ at ftable @code
+ at item \bf
+ at cindex bold font
+Switch to bold face.
+
+ at item \cal
+ at cindex script letters for math
+ at cindex calligraphic letters for math
+Switch to calligraphic letters for math.
+
+ at item \it
+ at cindex italic font
+Italics.
+
+ at item \rm
+ at cindex roman font
+Roman.
+
+ at item \sc
+ at cindex small caps font
+Small caps.
+
+ at item \sf
+ at cindex sans serif font
+Sans serif.
+
+ at item \sl
+ at cindex slanted font
+ at cindex oblique font
+Slanted (oblique).
+
+ at item \tt
+ at cindex typewriter font
+ at cindex monospace font
+ at cindex fixed-width font
+Typewriter (monospace, fixed-width).
+
+ at end ftable
+
+The @code{\em} command is the unconditional version of @code{\emph}.
+
+(Some people consider the unconditional font-switching commands, such as
+ at code{\tt}, obsolete and that only the cumulative commands
+(@code{\texttt}) should be used.  Others think that both sets of
+commands have their place and sometimes an unconditional font switch is
+precisely what you need; for an example 
+ at pxref{description,, at code{description}}.)
+
+The following commands are for use in math mode.  They are not
+cumulative, so @code{\mathbf at domain.hid}@}@}} does not create
+a boldface and italic @var{symbol}, instead it will just be in italics.
+This is because typically math symbols need a typographic treatment that
+is consistent, regardless of the surrounding environment.
+
+ at table @code
+
 @item \mathrm
 @findex \mathrm
 Roman, for use in math mode.
@@ -764,7 +832,7 @@
 
 @item \mathcal
 @findex \mathcal
-`Calligraphic' letters, for use in math mode.
+Calligraphic letters, for use in math mode.
 
 @end table
 
@@ -780,72 +848,17 @@
 @cindex old-style numerals
 @cindex lining numerals
 @cindex @code{textcomp} package
-Finally, the command @code{\oldstylenums at domain.hid}@}} will
-typeset so-called ``old-style'' numerals, which have differing heights
-and depths (and sometimes widths) from the standard ``lining''
-numerals.  @LaTeX{}'s default fonts support this, and will respect
- at domain.hid} (but not other styles; there are no italic old-style
-numerals in Computer Modern).  Many other fonts have old-style
-numerals also; sometimes the @code{textcomp} package must be loaded,
-and sometimes package options are provided to make them the default.
-FAQ entry: @url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf}.
-
- at domain.hid{} also provides the following commands, which unconditionally
-switch to the given style, that is, are @emph{not} cumulative.  Also,
-they are used differently than the above commands: @code{@{\@var{cmd}
-...@}} instead of @code{\@var{cmd}@{...@}}.  These are two unrelated
-constructs.
-
- at domain.hid @code
- at domain.hid \bf
- at domain.hid bold font
-Switch to @b{bold face}.
-
- at domain.hid \cal
- at domain.hid script letters for math
- at domain.hid calligraphic letters for math
-Switch to calligraphic letters for math.
-
- at domain.hid \em
- at domain.hid emphasis
-Emphasis (italics within roman, roman within italics).
-
- at domain.hid \it
- at domain.hid italic font
-Italics.
-
- at domain.hid \rm
- at domain.hid roman font
-Roman.
-
- at domain.hid \sc
- at domain.hid small caps font
-Small caps.
-
- at domain.hid \sf
- at domain.hid sans serif font
-Sans serif.
-
- at domain.hid \sl
- at domain.hid slanted font
- at domain.hid oblique font
-Slanted (oblique).
-
- at domain.hid \tt
- at domain.hid typewriter font
- at domain.hid monospace font
- at domain.hid fixed-width font
-Typewriter (monospace, fixed-width).
-
- at domain.hid ftable
-
-Some people consider the unconditional font-switching commands, such
-as @code{\tt}, obsolete and @emph{only} the cumulative commands
-(@code{\texttt}) should be used.  I (Karl) do not agree.  There are
-perfectly reasonable situations when an unconditional font switch is
-precisely what you need to get the desired output; for one example,
- at domain.hid}}.  Both sets of commands have
-their place.
+Finally, the command @code{\oldstylenums at domain.hid}@}} will typeset
+so-called ``old-style'' numerals, which have differing heights and
+depths (and sometimes widths) from the standard ``lining'' numerals,
+which all have the same height as upper-case letters.  @LaTeX{}'s
+default fonts support this, and will respect @code{\textbf} (but not
+other styles; there are no italic old-style numerals in Computer
+Modern).  Many other fonts have old-style numerals also; sometimes the
+ at code{textcomp} package must be loaded, and sometimes package options
+are provided to make them the default.  FAQ entry:
+ at url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf}.
+
 
 
 @node Font sizes