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

[jhefferon at domain.hid]

Author: jhefferon
Date: Mon Jun 22 02:49:53 2015
New Revision: 368

URL: http://svn.gna.org/viewcvs/latexrefman?rev=368&view=rev
Log:
\twocolumn dblfloat parameters

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=368&r1=367&r2=368&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Mon Jun 22 02:49:53 2015
@@ -1,4 +1,9 @@
-2015-06-20  Jim Hefferon  <jhefferon at domain.hid>
+2015-06-21  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (\twocolumn): Expand definition of the double
+	float parameters.
+
+202015-06-20  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (\twocolumn): Add example.
 

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=368&r1=367&r2=368&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Mon Jun 22 02:49:53 2015
@@ -1163,37 +1163,71 @@
 
 @ftable @code
 @item \columnsep
-The distance between columns (35pt by default).
+The distance between columns. The default is 35pt.
 
 @item \columnseprule
-The width of the rule between columns; the default is 0pt, so there is no rule.
+The width of the rule between columns. The default is 0pt, meaning that
+there is no rule.
 
 @item \columnwidth
-The width of the current column; this is equal to @code{\textwidth} in
-single-column text.
+The width of the current column.  In single-column text this is equal to
+ at code{\textwidth}.
 
 @end ftable
 
-These parameters control float behavior in two-column output:
+These parameters control float behavior in two-column output.  Note that
+in a two-column document, the starred environments @code{table*} and
+ at code{figure*} are two columns wide, whereas the unstarred environments
+ at code{table} and @code{figure} take up only one column (@pxref{figure}
+and @pxref{table}). @LaTeX{} places starred floats at the top of a page.
 
 @ftable @code
 @item \dbltopfraction
-Maximum fraction at the top of a two-column page that may be occupied
-by floats.  Default @samp{.7}, can be usefully redefined to (say)
- at domain.hid} to avoid going to float pages so soon.
+The maximum fraction at the top of a two-column page that may be
+occupied by two-column wide floats.  The default is 0.7, meaning that
+the height of a @code{table*} or @code{figure*} environment must not
+exceed @code{0.7\textheight} .  If the height of your starred float
+environment exceeeds this then you can take one of the following actions
+to prevent it from floating all the way to the back of the document:
+
+ at itemize @bullet
+ at item
+Use the @code{[tp]} location specifier to tell LaTeX to try to put
+the bulky float on a page by itself, as well as at the top of a page.
+
+ at item
+Use the @code{[t!]} location specifier to override the effect of
+ at code{\dbltopfraction} for this particular float.
+
+ at item
+Increase the value of @code{\dbltopfraction} to a suitably large number,
+to avoid going to float pages so soon.
+ at end itemize
+
+You can redefine it, for instance with
+ at code{\renewcommand at domain.hid@}}.
 
 @item \dblfloatpagefraction
-The minimum fraction of a float page that must be occupied by floats,
-for a two-column float page.  Default @samp{.5}.
+For a float page of two-column wide floats, this is the minimum fraction
+that must be occupied by floats, limiting the amount of blank space.
+ at LaTeX{}'s default is @code{0.5}.  Change it with @code{\renewcommand}.
 
 @item \dblfloatsep
-Distance between floats at the top or bottom of a two-column float
-page.  Default @samp{12pt plus2pt minus2pt} for @samp{10pt} and
- at domain.hid} documents, @samp{14pt plus2pt minus4pt} for @samp{12pt}.
+On a float page of two-column wide floats, this length is the distance
+between floats, at both the top and bottom of the page.  The default is
+ at code{12pt plus2pt minus2pt} for a document set at @code{10pt} or
+ at code{11pt}, and @code{14pt plus2pt minus4pt} for a document set at
+ at code{12pt}.
 
 @item \dbltextfloatsep
-Distance between a multi-column float at the top or bottom of a page
-and the main text.  Default @samp{20pt plus2pt minus4pt}.
+This length is the distance between a multi-column float at the top or
+bottom of a page and the main text.  The default is @code{20pt plus2pt
+minus4pt}.
+
+ at item \dbltopnumber
+On a float page of two-column wide floats, this counter gives the
+maximum number of floats allowed at the top of the page.  The @LaTeX{}
+default is @code{2}.
 
 @end ftable