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

jhefferon at domain.hid jhefferon at domain.hid
Sun Aug 9 02:43:05 CEST 2015


Author: jhefferon
Date: Sun Aug  9 02:43:05 2015
New Revision: 394

URL: http://svn.gna.org/viewcvs/latexrefman?rev=394&view=rev
Log:
center and centering

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=394&r1=393&r2=394&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sun Aug  9 02:43:05 2015
@@ -1,3 +1,8 @@
+2015-08-08  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (center, \centering): Add detail, including
+	distinguishing the two and examples.
+
 2015-08-05  Vincent Belaïche  <vincent.belaiche at domain.hid>
 
 	* latex2e.texi (\indent): remove "width of" concering concerning

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=394&r1=393&r2=394&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sun Aug  9 02:43:05 2015
@@ -1820,16 +1820,34 @@
 
 @example
 \begin at domain.hid@}
- at domain.hid} \\
- at domain.hid} \\
+ .. text ..
 \end at domain.hid@}
 @end example
 
+Environment to create a sequence of lines that are centered within the
+left and right margins on the current page.  If the text in the
+environment body is too long to fit on a line, @LaTeX{} will insert line
+breaks that avoid hyphenation and avoid stretching or shrinking any
+interword space.  To force a line break at a particular spot use
+double-backslash at domain.hid{\\} (@pxref{\\}).
 @findex \\ @r{(for @code{center})}
-The @code{center} environment allows you to create a paragraph
-consisting of lines that are centered within the left and right
-margins on the current page.  Each line is terminated with the
-string @code{\\}.
+
+This environment inserts space above and below the text body.
+ at xref{\centering} to avoid such space (for example, inside a
+ at code{figure} environment).
+
+In this example, depending on how long the page's lines are, @LaTeX{} may
+choose a break for the part before the double backslash, will center
+the line or two , then will break at the double backslash, and will center
+the ending.
+
+ at example
+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 
+ at end example
+
+A double backslash after the final line is optional.
 
 @menu
 * \centering::          Declaration form of the @code{center} environment.
@@ -1842,27 +1860,37 @@
 @findex \centering
 @cindex centering text, declaration for
 
-The @code{\centering} declaration corresponds to the @code{center}
-environment.  This declaration can be used inside an environment such
-as @code{quote} or in a @code{parbox}.  Thus, the text of a figure or
-table can be centered on the page by putting a @code{\centering}
-command at the beginning of the figure or table environment.
-
-Unlike the @code{center} environment, the @code{\centering} command
-does not start a new paragraph; it simply changes how @LaTeX{} formats
-paragraph units.  To affect a paragraph unit's format, the scope of
-the declaration must contain the blank line or @code{\end} command (of
-an environment such as quote) that ends the paragraph unit.
-
-Here's an example:
-
- at domain.hid
-\begin at domain.hid@}
-\centering
-first line \\
-second line \\
-\end at domain.hid@}
- at domain.hid example
+Declaration that causes material in its scope to be centered.  It is
+most often used inside an environment such as @code{figure}, or in a
+ at code{parbox}.
+
+Unlike the @code{center} environment, the @code{\centering} command does
+not add vertical space above and below the text.
+
+It also does not start a new paragraph; it simply changes how @LaTeX{}
+formats paragraph units.  If @code{ww @{\centering xx \\ yy@} zz} is
+surrounded by blank lines then @LaTeX{} will create a paragraph whose
+first line @samp{ww xx} is centered and whose second line, not centered,
+contains @samp{yy zz}.  Usually what is desired is for the scope of the
+declaration to contain a blank line or the @code{\end} command of an
+environment such as @code{figure} or @code{table} that ends the
+paragraph unit.  Thus, if @code{@{\centering xx \\ yy\par@} zz} is
+surrounded by blank lines then it makes a new paragraph with two
+centered lines @samp{xx} and @samp{yy}, followed by a new paragraph with
+ at samp{zz} that is formatted as usual.  See also the following example.
+
+This example's @code{\centering} causes the graphic to be horizontally
+centered.  
+
+ at example
+\begin at domain.hid@}
+  \centering
+  \includegraphics[width=0.6\textwidth]@{ctan_lion.png@}
+  \caption at domain.hid Lion@}  \label at domain.hid@}
+\end at domain.hid@}
+ at end example
+
+The scope of the @code{\centering} ends with the @code{\end at domain.hid@}}.
 
 
 @node description





More information about the latexrefman-commits mailing list