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

[jhefferon at domain.hid]

Author: jhefferon
Date: Sat Aug 22 20:39:38 2015
New Revision: 414

URL: http://svn.gna.org/viewcvs/latexrefman?rev=414&view=rev
Log:
fine tune wording of Floats

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=414&r1=413&r2=414&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sat Aug 22 20:39:38 2015
@@ -1,3 +1,8 @@
+2015-08-22  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (Floats): Change some wording, move description of
+	how float body is typeset to figure and table nodes.
+
 2015-08-22  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (various): Corrected Subversion mistake overwriting

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=414&r1=413&r2=414&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sat Aug 22 20:39:38 2015
@@ -1559,43 +1559,36 @@
 
 Some typographic elements, such as figures and tables, cannot be broken
 across pages.  They must be typeset outside of the normal flow of text,
-for instance, floating to the top of a later page.
-
-The body of the float is typeset in a @code{parbox} of width
- at domain.hid} and so it can contain text, commands, etc.
+for instance floating to the top of a later page.
 
 @LaTeX{} can have a number of different classes of floating material.
 The default is the two classes, @code{figure} (@pxref{figure}) and
 @code{table} (@pxref{table}) but you can create a new class with the
-package @file{float}.  Within any one float class @LaTeX{} always
-respects the order, so that the first figure in a document source must
-be typeset before the second figure.  However, @LaTeX{} may mix the
-classes, so it can happen that while the first table appears in the
-source before the first figure, it appears in the output after it.
-
-The float placement algorithm is subject to parameters that limit the
-number of floats that can appear at the top of a page, and the bottom,
-and the overall total on that page. There are also limits on the
-fraction of a page's area that can be occupied by floats at the top and
-bottom separately, as well as for the page as a whole.  If so many
-floats are queued up that the limits prevent them all from fitting on a
-page then @LaTeX{} places what it can and defers the rest to the next
-page.  In this way, floats may be typset far from their place in the
-source.  In particular, a float that is big can migrate to the end of
-the document. But then the rule that all floats in a class must appear
-in sequential order means that every subsequent float in that class also
-appears at the end.
+package @file{float}.
+
+Within any one float class @LaTeX{} always respects the order, so that
+the first figure in a document source must be typeset before the second
+figure.  However, @LaTeX{} may mix the classes, so it can happen that
+while the first table appears in the source before the first figure, it
+appears in the output after it.
+
+The placement of floats is subject to parameters, given below, that
+limit the number of floats that can appear at the top of a page, and the
+bottom, etc. If so many floats are queued up that the limits prevent
+them all from fitting on a page then @LaTeX{} places what it can and
+defers the rest to the next page.  In this way, floats may be typset far
+from their place in the source.  In particular, a float that is big can
+migrate to the end of the document. But then because all floats in a
+class must appear in sequential order, every subsequent float in that
+class also appears at the end.
 
 @cindex placement of floats
-One way that you can influence @LaTeX{}'s float placement algorithm is
-to change its parameters; see below.
-
 @cindex specifier, float placement
-In addition, for each float you can tweak where the float placement
-algorithm tries to place it, using its @var{placement} argument.  The
-possible values are a sequence of the letters below. The default for
-both @code{figure} and @code{table}, in both @code{article} and
- at domain.hid} classes, is @code{tbp}.
+In addition to changing the parameters, for each float you can tweak
+where the float placement algorithm tries to place it by using its
+ at var{placement} argument.  The possible values are a sequence of the
+letters below. The default for both @code{figure} and @code{table}, in
+both @code{article} and @code{book} classes, is @code{tbp}.
 
 @table @code
 @item t
@@ -1648,12 +1641,12 @@
 @code{\afterpage at domain.hid@}}.  This will wait until the current page
 is finished and then flush all outstanding floats.
 
- at domain.hid{} can put a float in the output before where it appears in the
-source, although on the same output page, if there is a @code{t} in the
-position specifier.  If this is not desired, deleting the @code{t} is
-typically not acceptible as it keeps the float from being placed at the
-top of the next page.  Instead you can prevent it by either using the
- at domain.hid} package, or using the command
+ at LaTeX{} can typeset a float before where it appears in the source
+(although on the same output page) if there is a @code{t} in the
+ at var{placement} specifier.  If this is not desired, and deleting the
+ at code{t} is not acceptible as it keeps the float from being placed at
+the top of the next page, then you can prevent it by either using the
+ at file{flafter} package or using the command
 @findex \suppressfloats 
 @code{\suppressfloats[t]}, which causes floats for the top position on
 this page to moved to the next page.
@@ -2534,6 +2527,9 @@
 placing at a page bottom see the discussion of @var{placement} @code{b}
 in @ref{Floats}.
 
+The figure body is typeset in a @code{parbox} of width @code{\textwidth}
+and so it can contain text, commands, etc.
+
 The label is optional; it is used for cross-references (@pxref{Cross
 references}).
 @findex \caption
@@ -3552,6 +3548,9 @@
 For the possible values of @var{placement} and their effect on the 
 float placement algorithm, see @ref{Floats}.
 
+The table body is typeset in a @code{parbox} of width @code{\textwidth}
+and so it can contain text, commands, etc.
+
 The label is optional; it is used for cross-references (@pxref{Cross
 references}).  
 @findex \caption