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

[jhefferon at domain.hid]

Author: jhefferon
Date: Tue Aug 11 18:06:29 2015
New Revision: 396

URL: http://svn.gna.org/viewcvs/latexrefman?rev=396&view=rev
Log:
displaymath

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=396&r1=395&r2=396&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Tue Aug 11 18:06:29 2015
@@ -1,3 +1,8 @@
+2015-08-11  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (displaymath): Add detail and an example.  Include
+	note on why $$ is not recommended.
+
 2015-08-09  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (description): Add detail and an example.

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=396&r1=395&r2=396&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Tue Aug 11 18:06:29 2015
@@ -18,6 +18,7 @@
 @c xx merge http://mirror.ctan.org/latex2e-reference.tar.gz
 @c xx merge permuted-index
 @c xx merge latex-manual from savannah
+ at c xx merge display style math
 @c
 @c xx The typeset source2e has an index with all kernel
 @c xx commands, though some are internal and shouldn't be included.
@@ -1918,9 +1919,9 @@
 @cindex typewriter labels in lists
 Since the labels are in bold style, if you typeset a label in typewriter
 with @code{\item[\texttt at domain.hid text@}]} then the label text will appear
-in bold typewriter (if that is available).  To get non-bolded
-typewriter, use @code{\item[@{\tt label text@}]} (to get normal text use
- at domain.hid label text@}]}).
+in bold typewriter, if that is available, so to get non-bolded
+typewriter, use @code{\item[@{\tt label text@}]}.  To get normal text
+use @code{\item[@{\rm label text@}]}.
 
 For other major @LaTeX{} list environments, see @ref{itemize} and
 @ref{enumerate}.  For information about customizing list layout, see
@@ -1938,6 +1939,7 @@
 
 @node displaymath
 @section @code{displaymath}
+ at c http://tex.stackexchange.com/questions/40492/what-are-the-differences-between-align-equation-and-displaymath
 
 @findex displaymath @r{environment}
 
@@ -1945,23 +1947,42 @@
 
 @example
 \begin at domain.hid@}
- at domain.hid}
+  .. math text ..
 \end at domain.hid@}
 @end example
 
- at domain.hid or
-
- at domain.hid
-\[@var{math}\]
- at domain.hid example
-
-The @code{displaymath} environment (@code{\[...\]} is a synonym)
-typesets the @var{math} text on its own line, centered by default.
-The global @code{fleqn} option makes equations flush left; see
- at domain.hid class options}.
-
-No equation number is added to @code{displaymath} text; to get an
-equation number, use the @code{equation} environment (@pxref{equation}).
+Environment to typeset the math text on its own line, in display style
+and centered.  To make the text be flush-left use the global option
+ at code{fleqn}; see @ref{Document class options}.
+
+In the @code{displaymath} environment no equation number is added to the
+math text. One way to get an equation number is to use the
+ at code{equation} environment (@pxref{equation}).
+
+The @file{amsmath} package has extensive displayed equation facilities.
+Those facilities are the best approach for such output in new documents.
+
+The construct @code{\[..math text..\]} is essentially a synonym for
+ at code{\begin at domain.hid text..\end at domain.hid@}} but the
+latter is easier to work with in the source file; for instance,
+searching for a square bracket may get false positives but the word
+ at code{displaymath} will likely be unique.  (The construct @code{$$..math
+text..$$} from Plain at domain.hid{} is sometimes mistakenly used as a
+synonym for @code{displaymath}.  It is not a synonym, because the
+ at code{displaymath} environment checks that it isn't started in math mode
+and that it ends in math mode begun by the matching environment start,
+because the @code{displaymath} environment has different vertical
+spacing, and because the @code{displaymath} environment honors the
+ at code{fleqn} option.)
+
+The output from this example is centered and alone on its line. 
+ at example
+\begin at domain.hid@}
+  \int_3^4 x^2\,dx=7/3
+\end at domain.hid@}
+ at end example
+Also, the integral sign is larger than the inline version  
+ at code{\( \int_3^4 x^2\,dx=7/3 \)} produces.
 
 
 @node document