diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/placeins/placeins.txt | |
parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/placeins/placeins.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/placeins/placeins.txt | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/placeins/placeins.txt b/Master/texmf-dist/doc/latex/placeins/placeins.txt new file mode 100644 index 00000000000..aee762d13d1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/placeins/placeins.txt @@ -0,0 +1,43 @@ + + p l a c e i n s . s t y ver 2.2 April 18, 2005 + Donald Arseneau asnd@triumf.ca + + +Placeins.sty keeps floats `in their place', preventing them from floating +past a "\FloatBarrier" command into another section. To use it, declare +"\usepackage{placeins}" and insert "\FloatBarrier" at places that floats +should not move past, perhaps at every "\section". + +Option: [section] + +A more convenient way to stop floats at section boundaries is to change +the definition of "\section" to include "\FloatBarrier", either at the +beginning, before "\@startsection", or in the `style' specification (see +The LaTeX Companion, section 2.2.2; or 2.3 in the 1st ed). If you specify +"\usepackage[section]{placeins}", then the "\section" command will be +redefined with "\FloatBarrier" inserted at the beginning. + +Options: [above] [below] + +Something you may not like is that, by default, "\FloatBarrier" is very +strict, and will (try to) prevent a float from appearing above the start +of the current section or below the start of the next section, even +though the float is still on the same page as its intended section. +Each restriction can be relaxed separately by using the "[above]" and +"[below]" package options: "[above]" allows floats to appear above their +section, if on the same page; "[below]" allows below. + +NOTE! The original version of placeins.sty acted like it was loaded +with the option "[above]" specified. + +There is a problem with LaTeX's "\suppressfloats" being out of step with +the page breaking (see usenet msg <yfi656pbsn0.fsf@triumf.ca> and thread) +which sometimes allows a float to go above a "\FloatBarrier" placed near +the top of a page. Maybe placeins will fix it sometime later. + +Option: [verbose] + +There is a package option "[verbose]" that causes many messages to be +written in the log file. It might be used to answer the question: +`How did *that* get *there*?!?' + |