summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/floatflt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-08-07 22:52:49 +0000
committerKarl Berry <karl@freefriends.org>2011-08-07 22:52:49 +0000
commitcd1184b0b8cac0389c4d4a96444d5d3ac3673b16 (patch)
treecfbd11518c3cb13792479f77d0ba9aaa8281376a /Master/texmf-dist/doc/latex/floatflt
parentb9796f07afb63ea44bdf7109294476668d4d1c5f (diff)
floatflt restored, since license changed (tex-live mail 3aug11)
git-svn-id: svn://tug.org/texlive/trunk@23445 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/floatflt')
-rw-r--r--Master/texmf-dist/doc/latex/floatflt/README30
-rw-r--r--Master/texmf-dist/doc/latex/floatflt/floatexm.tex375
-rw-r--r--Master/texmf-dist/doc/latex/floatflt/floatfge.tex317
-rw-r--r--Master/texmf-dist/doc/latex/floatflt/floatfig.txt18
-rw-r--r--Master/texmf-dist/doc/latex/floatflt/floatflt.pdfbin0 -> 304512 bytes
5 files changed, 740 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/floatflt/README b/Master/texmf-dist/doc/latex/floatflt/README
new file mode 100644
index 00000000000..1583b8853ab
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/floatflt/README
@@ -0,0 +1,30 @@
+
+This is the file `00readme.flt', which accompanies the `floatflt'
+package distribution. The package defines environments for figures
+and tables which do not span the full width of a page. The 'floatflt'
+package is is an extension of Thomas Kneser's style option 'floatfig.sty'
+for LaTeX 2.09, on which it is based. To use the package, run LaTeX on
+`floatflt.ins', this produces the files `floatflt.sty', which contains
+the macro definitions, and the file `floatexm.tex', which is an example
+of the use of the package. To obtain the userguide and documentation,
+run LaTeX on `floatflt.dtx' twice. To obtain the example, run LaTeX
+on `floatexm.tex' twice.
+
+The 'floatflt' package consists of two files:
+ floatflt.ins - the installation driver
+ floatflt.dtx - the macro code, instructions on how to use
+ the package, an example, and the original
+ documentation by Thomas Kneser, all in
+ `docstrip'-able format.
+Anyone is free to re-distribute these files provided the restrictions
+mentioned in 'floatflt.ins' are obeyed. These are mainly that the
+two files always must be distributed together.
+
+Inquiries can be sent to: <matsd@sssk.se>. You can also visit
+my LaTeX web page at http://www.homenet.se/matsd/latex/
+This file was last modified on 2008/03/17.
+
+
+____________________________________________________________________
+Copyright (c) 1998 by Mats Dahlgren.
+
diff --git a/Master/texmf-dist/doc/latex/floatflt/floatexm.tex b/Master/texmf-dist/doc/latex/floatflt/floatexm.tex
new file mode 100644
index 00000000000..fc7a2522340
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/floatflt/floatexm.tex
@@ -0,0 +1,375 @@
+%%
+%% This is file `floatexm.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% floatflt.dtx (with options: `exempelkod')
+%%
+%% Copyright (c) 1994-1998 by Mats Dahlgren <matsd@sssk.se>.
+%% All rights reserved. See the file `floatflt.ins' for information
+%% on how you may (re-)distribute the `floatflt' package files.
+%% You are not allowed to make any changes to this file without
+%% explicit permission from the author.
+%%
+\documentclass[11pt]{article}
+\usepackage{floatflt}
+\begin{document}
+\centerline{\Huge The Tale of
+\textsf{floatflt}}\bigskip
+
+\noindent This is a demonstration document for the use
+of the \textsf{floatflt} package. It contains several
+floating figures and tables with captions explaining how
+they were called. At the end, both a
+\verb+\listoffigures+ and a \verb+\listoftables+ command
+are used, resulting in the desired lists. For more
+details on how to use the \textsf{floatflt} package,
+please run \LaTeX{} on the file \texttt{floatflt.dtx}.
+
+The following work by Edgar Alan Poe was retrieved by
+anonymous ftp from \texttt{ftp.funet.fi} in the
+directory \texttt{/pub/doc/literary/etext} where it is
+found in the file \texttt{telltale.poe}. Only minor
+\LaTeX\ adaptions have been done, besides the inclusion
+of floating floats.
+
+\begin{center}
+Internet Wiretap Edition of\\[2mm]
+{\large THE TELL-TALE HEART}\\
+by\\ {\large EDGAR ALLAN POE}\\[2mm]
+From \textit{The Works of Edgar Allan Poe: Tales Vol I}\\
+J. B. Lippincott Co, Copyright 1895.\\[2mm]
+This text is placed into the Public Domain (May 1993).\\
+\end{center}
+
+\noindent\textit{\Large The Tell-Tale Heart}
+
+\noindent TRUE! nervous, very, very dreadfully nervous
+I had been and am; but why WILL you say
+that I am mad? The disease had sharpened
+my senses, not destroyed, not dulled them. Above
+all was the sense of hearing acute. I heard all things
+in the heaven and in the earth. I heard many things
+in hell. How then am I mad? Hearken! and observe how healthily, how
+calmly, I can tell you the
+whole story.
+
+\begin{floatingfigure}{60mm}
+\begin{center}
+The first figure to\\ use the environment\\ \texttt{floatingfigure}
+\end{center}
+\caption{The \texttt{floatingfigure} environment with \texttt{60mm}
+for \textit{width} and no \textit{option}.}
+\end{floatingfigure}
+It is impossible to say how first the idea entered
+my brain, but, once conceived, it haunted me day
+and\linebreak night. Object there was none. Passion there
+was none. I loved the old man. He had never
+wronged me. He had never given me insult. For
+his gold I had no desire. I think it was his eye!
+Yes, it was this! One of his eyes resembled that
+of a vulture -- a pale blue eye with a film over it.
+Whenever it fell upon me my blood ran cold, and
+so by degrees, very gradually, I made up my mind
+to take the life of the old man, and thus rid myself
+of the eye for ever.
+
+\begin{floatingfigure}[r]{40mm}
+\begin{center}
+Another figure to\\ use the environment\\ \texttt{floatingfigure}
+\end{center}
+\caption{The \texttt{floatingfigure} environment with \texttt{40mm}
+for \textit{width} and the \texttt{r} \textit{option}.}
+\end{floatingfigure}
+Now this is the point. You fancy me mad. Madmen
+know nothing. But you should have seen me.
+You should have seen how wisely I proceeded --
+with what caution -- with what foresight, with what
+dissimulation, I went to work! I was never kinder
+to the old man than during the whole week before
+I killed him. And every night about midnight I
+turned the latch of his door and opened it oh, so
+gently! And then, when I had made an opening
+sufficient for my head, I put in a dark lantern all
+closed, closed so that no light shone out, and then
+I thrust in my head. Oh, you would have laughed
+to see how cunningly I thrust it in! I moved it
+slowly, very, very slowly, so that I might not
+disturb the old man's sleep. It took me an hour to
+place my whole head within the opening so far that
+I could see him as he lay upon his bed. Ha! would
+a madman have been so wise as this? And then
+when my head was well in the room I undid the
+lantern cautiously -- oh, so cautiously -- cautiously
+(for the hinges creaked), I undid it just so much
+that a single thin ray fell upon the vulture eye.
+And this I did for seven long nights, every night
+just at midnight, but I found the eye always closed,
+and so it was impossible to do the work, for it was
+not the old man who vexed me but his Evil Eye.
+And every morning, when the day broke, I went
+boldly into the chamber and spoke courageously to
+him, calling him by name in a hearty tone, and
+inquiring how he had passed the night. So you see
+he would have been a very profound old man, indeed,
+to suspect that every night, just at twelve, I
+looked in upon him while he slept.
+
+\begin{floatingtable}{
+\begin{tabular}{cccc}
+$x$ & $x^2$ & $x^3$ & $x^4$ \\ \hline
+1 & 1 & 1 & 1 \\
+2 & 4 & 8 & 16 \\
+3 & 9 & 27 & 81 \\
+\end{tabular}}
+\caption{The \texttt{floatingtable} environment with no \textit{option}.}
+\end{floatingtable}
+Upon the eighth night I was more than usually
+cautious in opening the door. A watch's minute
+hand moves more quickly than did mine. Never
+before that night had I felt the extent of my own
+powers, of my sagacity. I could scarcely contain
+my feelings of triumph. To think that there I was
+opening the door little by little, and he not even to
+dream of my secret deeds or thoughts. I fairly
+chuckled at the idea, and perhaps he heard me, for
+he moved on the bed suddenly as if startled. Now
+you may think that I drew back -- but no. His room
+was as black as pitch with the thick darkness (for
+the shutters were close fastened through fear of
+robbers), and so I knew that he could not see the
+opening of the door, and I kept pushing it on
+steadily, steadily.
+
+\begin{floatingtable}[l]{
+\begin{tabular}{ccc}
+$\alpha$ & $\sin\alpha$ & $\cos\alpha$ \\ \hline
+0 & 0 & 1 \\
+$\pi$ & 0 & $-1$ \\
+$2\pi$ & 0 & 1 \\
+\end{tabular}}
+\caption{The \texttt{floatingtable} environment with the \texttt{l}
+\textit{option}.}
+\end{floatingtable}
+I had my head in, and was about to open the
+lantern, when my thumb slipped upon the tin fasten\-ing,
+and the old man sprang up in the bed, crying
+out, ''Who's there?''
+
+I kept quite still and said nothing. For a whole
+hour I did not move a muscle, and in the meantime
+I did not hear him lie down. He was still sitting
+up in the bed, listening; just as I have done night
+after night hearkening to the death watches in the
+wall.
+
+\begin{floatingfigure}[l]{50mm}
+\begin{center}
+\Large A Figure!
+\end{center}
+\caption{The \texttt{floatingfigure} environment
+with \textit{width} set to \texttt{50mm} and the
+\texttt{l} \textit{option}.}
+\end{floatingfigure}
+Presently, I heard a slight groan, and I knew it
+was the groan of mortal terror. It was not a groan of
+pain or of grief -- oh, no! It was the low stifled sound
+that arises from the bottom of the soul when
+overcharged with awe. I knew the sound well. Many
+a night, just at midnight, when all the world slept,
+it has welled up from my own bosom, deepening,
+with its dreadful echo, the terrors that distracted
+me. I say I knew it well. I knew what the old
+man felt, and pitied him although I chuckled at
+heart. I knew that he had been lying awake ever
+since the first slight noise when he had turned in
+the bed. His fears had been ever since growing
+upon him. He had been trying to fancy them
+causeless, but could not. He had been saying to
+himself, ''It is nothing but the wind in the chimney,
+it is only a mouse crossing the floor,'' or, ''It is merely
+a cricket which has made a single chirp.'' Yes he
+has been trying to comfort himself with these
+suppositions; but he had found all in vain. ALL IN VAIN,
+because Death in approaching him had stalked with
+his black shadow before him and enveloped the
+victim. And it was the mournful influence of the
+unperceived shadow that caused him to feel, although
+he neither saw nor heard, to feel the presence
+of my head within the room.
+
+When I had waited a long time very patiently
+without hearing him lie down, I resolved to open
+a little -- a very, very little crevice in the lantern.
+So I opened it -- you cannot imagine how stealthily,
+stealthily -- until at length a single dim ray like the
+thread of the spider shot out from the crevice and
+fell upon the vulture eye.
+
+It was open, wide, wide open, and I grew furious
+as I gazed upon it. I saw it with perfect distinctness
+-- all a dull blue with a hideous veil over it that
+chilled the very marrow in my bones, but I could
+see nothing else of the old man's face or person, for
+I had directed the ray as if by instinct precisely upon
+the damned spot.
+
+And now have I not told you that what you mis-
+take for madness is but over-acuteness of the senses?
+now, I say, there came to my ears a low, dull, quick
+sound, such as a watch makes when enveloped in
+cotton. I knew that sound well too. It was the
+beating of the old man's heart. It increased my fury
+as the beating of a drum stimulates the soldier into
+courage.
+
+\begin{floatingfigure}[p]{90mm}
+\begin{center}
+A rather wide figure which still uses the \\
+\texttt{floatingfigure} environment.
+\end{center}
+\caption{A \texttt{floatingfigure} environment
+which uses \texttt{90mm} for \textit{width} and
+the \texttt{p} \textit{option}.}
+\end{floatingfigure}
+But even yet I refrained and kept still. I scarcely\linebreak
+brea\-thed. I held\linebreak the lantern motionless. I tried
+how\linebreak stead\-ily I could\linebreak
+maintain the ray upon the eye.
+Meantime the hellish tattoo of the heart increased.
+It grew quicker and quicker, and louder and louder,
+every instant. The old man's terror must have
+been extreme! It grew louder, I say, louder every
+moment! -- do you mark me well? I have told you
+that I am nervous: so I am. And now at the dead
+hour of the night, amid the dreadful silence of that
+old house, so strange a noise as this excited me to
+uncontrollable terror. Yet, for some minutes longer
+I refrained and stood still. But the beating grew
+louder, louder! I thought the heart must burst.
+And now a new anxiety seized me -- the sound would
+be heard by a neighbour! The old man's hour had
+come! With a loud yell, I threw open the lantern
+and leaped into the room. He shrieked once -- once
+only. In an instant I dragged him to the floor, and
+pulled the heavy bed over him. I then smiled
+gaily, to find the deed so far done. But for many
+minutes the heart beat on with a muffled sound.
+This, however, did not vex me; it would not be
+heard through the wall. At length it ceased. The
+old man was dead. I removed the bed and examined
+the corpse. Yes, he was stone, stone dead. I placed
+my hand upon the heart and held it there many
+minutes. There was no pulsation. He was stone
+dead. His eye would trouble me no more.
+
+\begin{floatingtable}[r]{
+\begin{tabular}{l}
+Two lines in one table with one single \\
+column is enough!
+\end{tabular}}
+\caption{This \texttt{floatingtable} uses the \texttt{r}
+\textit{option}.}
+\end{floatingtable}
+If still you think me mad, you will think so no
+longer when I describe the wise precautions I took
+for the concealment of the body. The night waned,
+and I worked hastily, but in silence.
+
+I took up three planks from the flooring of the
+chamber, and deposited all between the scantlings.
+I then replaced the boards so cleverly so cunningly,
+that no human eye -- not even his -- could have
+detected anything wrong. There was nothing to wash
+out -- no stain of any kind -- no blood-spot whatever.
+I had been too wary for that.
+
+When I had made an end of these labours, it was
+four o'clock -- still dark as midnight. As the bell
+sounded the hour, there came a knocking at the
+street door. I went down to open it with a light
+heart, -- for what had I now to fear? There entered
+three men, who introduced themselves, with perfect
+suavity, as officers of the police. A shriek had been
+heard by a neighbour during the night; suspicion
+of foul play had been aroused; information had been
+lodged at the police office, and they (the officers)
+had been deputed to search the premises.
+
+\begin{floatingtable}[p]{
+\begin{tabular}{|l|l|l|} \hline
+English Word & Swedish Word & Dutch Word \\ \hline
+read & l\"asa & lesen \\
+speak & tala & spreken\\
+write & skriva & schrijven \\ \hline
+\end{tabular}}
+\caption{A \texttt{floatingtable} with the \texttt{p}
+\textit{option}.}
+\end{floatingtable}
+I smiled, -- for what had I to fear? I bade the
+gentlemen welcome. The shriek, I said, was my
+own in a dream. The old man, I mentioned,\linebreak was
+absent in the country. I took my visitors all over
+the house. I bade them search -- search well. I led
+them, at length, to his chamber. I showed them his
+treasures, secure, undisturbed. In the enthusiasm
+of my confidence, I brought chairs into the room,
+and desired them here to rest from their fatigues,
+while I myself, in the wild audacity of my perfect
+triumph, placed my own seat upon the very spot
+beneath which reposed the corpse of the victim.
+
+The officers were satisfied. My MANNER had
+convinced them. I was singularly at ease. They sat
+and while I answered cheerily, they chatted of
+familiar things. But, ere long, I felt myself getting
+pale and wished them gone. My head ached, and
+I fancied a ringing in my ears; but still they sat,
+and still chatted. The ringing became more distinct:
+I talked more freely to get rid of the feeling:
+but it continued and gained definitiveness -- until,
+at length, I found that the noise was NOT within my
+ears.
+
+No doubt I now grew VERY pale; but I talked
+more fluently, and with a heightened voice. Yet
+the sound increased -- and what could I do? It was
+A LOW, DULL, QUICK SOUND -- MUCH SUCH A SOUND AS A
+WATCH MAKES WHEN ENVELOPED IN COTTON. I gasped for
+breath, and yet the officers heard it not. I talked
+more quickly, more vehemently but the noise
+steadily increased. I arose and argued about trifles,
+in a high key and with violent gesticulations; but
+the noise steadily increased. Why WOULD they not
+be gone? I paced the floor to and fro with heavy
+strides, as if excited to fury by the observations of
+the men, but the noise steadily increased. O God!
+what COULD I do? I foamed -- I raved -- I swore! I
+swung the chair upon which I had been sitting, and
+grated it upon the boards, but the noise arose over
+all and continually increased. It grew louder --
+louder -- louder! And still the men chatted
+pleasantly, and smiled. Was it possible they heard
+not? Almighty God! -- no, no? They heard! --
+they suspected! -- they KNEW! -- they were making
+a mockery of my horror! -- this I thought, and this
+I think. But anything was better than this agony!
+Anything was more tolerable than this derision! I
+could bear those hypocritical smiles no longer! I
+felt that I must scream or die! -- and now -- again
+-- hark! louder! louder! louder! LOUDER! --
+
+''Villains!'' I shrieked, ''dissemble no more! I
+admit the deed! -- tear up the planks! -- here, here!
+-- it is the beating of his hideous heart!''
+
+\rightline{\ensuremath{\mathcal{END}}.}
+
+\listoffigures
+\listoftables
+
+\end{document}
+\endinput
+%%
+%% End of file `floatexm.tex'.
diff --git a/Master/texmf-dist/doc/latex/floatflt/floatfge.tex b/Master/texmf-dist/doc/latex/floatflt/floatfge.tex
new file mode 100644
index 00000000000..97786326466
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/floatflt/floatfge.tex
@@ -0,0 +1,317 @@
+%%
+%% This is file `floatfge.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% floatflt.dtx (with options: `gammalkod')
+%%
+%% Copyright (c) 1994-1998 by Mats Dahlgren <matsd@sssk.se>.
+%% All rights reserved. See the file `floatflt.ins' for information
+%% on how you may (re-)distribute the `floatflt' package files.
+%% You are not allowed to make any changes to this file without
+%% explicit permission from the author.
+%%
+ \documentclass[11pt]{article}
+ %
+ \textheight=1.1\textheight
+ \textwidth=1.15\textwidth
+ \oddsidemargin=0pt
+ \evensidemargin=0pt
+ %
+ \begin{document}
+ %
+ \title{\LaTeX-Paragraphs Floating around Figures}
+ \author{{\it Thomas Kneser}\\{\footnotesize
+ Gesellschaft f\"ur wissenschaftliche Datenverarbeitung
+ mbH G\"ottingen, FRG}}
+ \date{August 20, 1990}
+ \maketitle
+ %
+ \begin{abstract}
+ %
+ \noindent Frequently figures do not fill the full pagewidth.
+ If the width of such figures is only half of the
+ pagewidth or even less,
+ textlines should be set beside the figures,
+ or -- from another point of view -- figures should `float'
+ in paragraphs.
+ This article presents the \LaTeX{} style option {\tt FLOATFIG}
+ which can be used to set such Floating Figures as easily
+ as \LaTeX's standard figures.
+ \end{abstract}
+ %
+ \section{The name of the game}
+ The macros which make up the {\tt FLOATFIG} style option
+ are based on PLAIN-\TeX\ macros developed by Thomas Reid
+ (TUGBoat Vol. 8 \# 3 page 315), who pointed out
+ how to set figures
+ {\bf right justified} with paragraphs floating around them.
+ For such objects
+ Th. Reid has chosen the term `Floating Figures'.
+
+ This choice might cause some confusion,
+ when we adapt these macros for \LaTeX,
+ since Leslie Lamport uses the term `float' for objects
+ which are realized as \TeX-\verb+\inserts+.
+ While L. Lamports floats are floating in `main vertical list',
+ floats introduced by Th. Reid
+ are floating in paragraphs.
+ For the following we adopt the latter meaning.
+ \section{How to use it}
+ The Floating Figures style option is fully compatible with
+ \LaTeX's standard figure facility:
+ \begin{enumerate}
+ \item Floating Figures and standard figures may be requested
+ in any sequence,
+ \item Floating Figures can be captioned like standard figures,
+ \item captioned Floating Figures are inserted in the list of figures
+ which may be printed by the standard
+ \verb+\listoffigures+ command.
+ \end{enumerate}
+ A Floating Figure may be requested as follows:
+ \begin{verbatim}
+ \documentstyle[floatfig]{article}
+ \begin{document}
+ \initfloatingfigs
+ .
+ .
+ \begin{floatingfigure}{5.6cm}
+ \vspace{6.cm}
+ \caption{Intermolecular potential K-Xe}% optional !
+ \end{floatingfigure}
+ .
+ .
+ \end{document}
+ \end{verbatim}
+ where {\tt 5.6cm} specifies the width of the figure space.
+ A Floating Figure may only be requested in vertical mode, that is
+ between paragraphs.
+
+ A Floating Figure will be set as soon as possible after its request
+ has be encountered by \TeX.
+ That means,
+ it will be tested if there is enough vertical space
+ on the current page;
+ otherwise the figure moves to the next page.
+
+ Floating Figures are set {\bf alternating},
+ that is on the right hand side on odd and
+ on the left hand side on even numbered pages.
+ %
+ \subsection{Restrictions}
+ \begin{enumerate}
+ \item The {\tt FLOATFIG} style option may not be combined with the
+ {\tt TWOCOLUMN} style option,
+ \item a Floating Figure will never appear in a paragraph
+ which begins on top of a page.
+ \end{enumerate}
+ %
+ \section{About the internals}
+ %
+ We have extended the macros designed by Th.~Reid with regard to:
+ \begin{enumerate}
+ \item implantation into the \LaTeX{} context,
+ \item alternating setting of Floating Figures as explained above,
+ \item generation of warning messages for `collisions' of
+ two Floating Figures.
+ \end{enumerate}
+ %
+ \subsection{Implantation into the \LaTeX{} context}
+ The PLAIN-\TeX{} implementation by Th.~Reid
+ is based on a redefined \verb+\output+ routine:
+ %
+ \begin{verbatim}
+ \edef\oldoutput{\the\output}%
+ \output={\the\outputpretest\ifoutput\oldoutput\fi}
+ \outputpretest={\outputtrue}
+ \end{verbatim}
+ %
+ If a Floating Figure is requested,
+ the content of the
+ \verb+\outputpretest+ token register is prepared to decide:
+ \begin{enumerate}
+ \item if there is enough vertical space to set the Floating Figure,
+ \item if setting of a Floating Figure is in progress or
+ \item if indeed the current page has to be sent to the DVI file.
+ \end{enumerate}
+ %
+ In general, \TeX{} has to deal with more than one paragraph until
+ a Floating Figure will be completely processed.
+ During this process
+ the redefined \verb+\output+ routine is
+ called at the begin of {\bf every} paragraph;
+ this is done indirectly
+ by expanding the control sequence \verb+\tryfig+.
+ Therefore, the \verb+\everypar+ token
+ list is prepared by the following command sequence:
+ \begin{verbatim}
+ \edef\oldeverypar{\the\everypar}
+ \everypar={\tryfig\oldeverypar}
+ \end{verbatim}
+ Now \verb+\tryfig+ triggers the (modified)
+ \verb+\output+ routine, which then does the decisions
+ and actions mentioned above.
+
+ Adopting this concept when using the macros in the \LaTeX{} context,
+ we are faced with the following problems:
+ \begin{enumerate}
+ \item At the time \hbox{\tt FLOATFIG.STY} is read in,
+ the \verb+\output+ routine is still undefined;
+ its definition is retarded until
+ \verb+\begin{document}+ will be expanded;
+ so the redefinition of the \verb+\output+ routine has to be
+ done after \verb+\begin{document}+
+ by the command \verb+\initfloatingfigs+
+ (see section `Known Problems' below).
+ \item There are situations where
+ \LaTeX{} decides to redefine the \verb+\everypar+ token list
+ without saving of the former content;
+ this occurs for instance when expanding
+ a \verb+\section+ control sequence.
+ We overcome this by redefining \verb+\everypar+ whenever
+ the \verb+\floatingfigure+ environment is entered.
+ %
+ Hence to avoid problems, a Floating Figure should be requested
+ early enough before any sectioning control sequence
+ (see also subsection `Misleading collision warnings').\hfil\break
+ %
+ Furthermore, the concurrent definitions of
+ \verb+\everypar+ are the reason why
+ Floating Figures cannot move across section boundaries.
+ \end{enumerate}
+ %
+ \subsection{Alternating figure setting}
+ The problem to be solved
+ is to decide if a certain figure has to be set
+ left- or rightjustified.
+ This decision has to made according to
+ the value of the pagecount (left if even, right if odd).
+ That is we are dealing with the wellknown problem
+ to associate a certain part of input text with the number
+ of the page on which it will be set finally.
+
+ As pointed out by D.E. Knuth in `The {\TeX}book' this association
+ is done not before \verb+\output+ routine time.
+ But the problem is not so hard to solve,
+ since in Th.~Reid's version there is already a modified
+ \verb+\output+ routine which decides if a certain figure will
+ fit on the current page.
+ As a by-product of this decision one easily gains
+ the information `odd' or `even' for the pagecount
+ of the current page.
+ So our problem reduces to the following simple decision:
+ \begin{verbatim}
+ \ifodd\count0 %
+ \hbox to \hsize{\hss\copy\figbox}%
+ \global\oddpagestrue
+ \else% leftsetting
+ \hbox to \hsize{\copy\figbox\hss}%
+ \global\oddpagesfalse
+ \fi% \ifodd\count0
+ \end{verbatim}
+ %
+ \subsection{Collisions of Floating Figures}
+ We define a collision as a situation where:
+ \begin{enumerate}
+ \item a Floating Figure is requested before the predecessor
+ has been finished,
+ \item some sectioning is requested before a Floating Figure has been
+ finished.
+ \end{enumerate}
+
+ While the {\tt FLOATFIG} style option cannot avoid such collisions,
+ it will recognize them.
+ For diagnostic purposes we have therefore defined
+ the switch \verb+\iffigprocessing+ and another count register called
+ \verb+\ffigcount+.
+ This count register is used to attach
+ a sequence number to each Floating Figure,
+ so they can be identified uniquely within collision warning messages.
+ These sequence numbers are not to be confused
+ with the figure count maintained by standard \LaTeX.
+ %
+ \section{Known Problems}
+ \subsection{Need of Initialization}
+ The present version of the style option needs to be initialized
+ by control sequence
+ {\tt\verb+\initfloatingfigs+} as mentioned above.\footnote{%
+ This is not needed with \LaTeXe{}. /MD}
+
+ We hope a later version will initialize itself,
+ when the first request to a Floating Figure is encountered.
+ One problem with such an automatic initialization seems
+ to be,
+ that we are grouped down
+ since we are inside a \LaTeX{} environment.
+ Our first attempt failed
+ to make the respective settings \verb+\global+.
+ %
+ \subsection{Misleading collision warnings}
+ As mentioned above, Floating Figures do not move
+ across section boundaries.
+ If a Floating Figure is requested near a section end,
+ the figure will be truncated,
+ if it does not fit in the current section.
+
+ If this occurs for instance with floating figure number~4,
+ a collision will be reported when the request for
+ floating figure number~5 is encountered;
+ so the respective warning message may be substantially retarded.
+ In fact, the message will tell us that there is a problem with figure~4,
+ but there will be no further hint.
+ So one has to analyze `by hand' that the problem is {\bf not} caused
+ by collision with figure~5 but with a section heading;
+ even worse: if there is no floating figure~5, one gets no warning message
+ at all.
+
+ Furthermore, warning messages will be generated if a Floating Figure
+ ends in paragraph $n$ and the next one begins with paragraph $n+1$.
+ These warning messages are to be ignored; they are due to some retardation
+ caused by the \verb+\everypar+ mechanism.
+ %
+ \section{Conclusions}
+ Working on \texttt{FLOATFIG.STY} we had some unexpected problems
+ which were caused
+ by \LaTeX's somewhat unsafe assignments to the \verb+\everypar+ token list.
+ This is due to the fact that the use
+ of this token list is fundamental
+ to the algorithm designed by Th.~Reid.
+ On the other hand we did expect problems to couple
+ the Floating Figures with \LaTeX's figure caption adminstration,
+ that is to achieve a single figure caption numbering for
+ the standard figures and the Floating Figures and to get both types
+ listed by the \verb+\listoffigures+ control sequence.
+ %
+ But these problems could easily be solved
+ by the following local definiton within the {\tt FLOATFIG} environment:
+ \begin{verbatim}
+ \def\@captype{figure}
+ \end{verbatim}
+ Obviously this is due to the fact
+ that \LaTeX's caption apparatus is thoroughly parameterized.
+
+ The \verb+FLOATFIG.STY+ file is stored in the
+ {\tt EARN/BITNET} listserver
+ in Heidelberg; \hfil\break
+ {\tt VM/CMS} users should enter the commands:
+ \begin{verbatim}
+ TELL LISTSERV AT DHDURZ1 GET LATEXSTY INDEX
+ TELL LISTSERV AT DHDURZ1 GET LATEXSTY README
+ TELL LISTSERV AT DHDURZ1 GET LATEXSTY FILELIST
+ TELL LISTSERV AT DHDURZ1 GET FLOATFIG ZOOUUE LATEXSTY
+ \end{verbatim}
+ to obtain information about how to obtain the style option file.
+\subsection{Note by Mats Dahlgren}
+Several features described in this document still apply to the
+\LaTeXe\ \texttt{floatflt} package, whereas others do not. Please
+run \LaTeX{} on \texttt{floatflt.dtx} twice and read the resulting
+documentation before you use the package.
+(This note was added on October 20, 1994; changed on December 27,
+1994.)
+
+ %\tableofcontents
+ \end{document}
+\endinput
+%%
+%% End of file `floatfge.tex'.
diff --git a/Master/texmf-dist/doc/latex/floatflt/floatfig.txt b/Master/texmf-dist/doc/latex/floatflt/floatfig.txt
new file mode 100644
index 00000000000..4a5747afd13
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/floatflt/floatfig.txt
@@ -0,0 +1,18 @@
+
+This is the file `floatfig.txt', which accompanies the `floatflt'
+package distribution. Thomas Kneser's style option for LaTeX 2.09
+`floatfig.sty' has been extended somewhat for LaTeX2e. The extended
+package is called `floatflt'. Please see the file `00readme.flt'
+for more information on the `floatflt' package. This file is only
+intended to be a pointer for `floatfig.sty' users to the `floatflt'
+package (as recommended by CJ DOHERTY <dohertcj@aston.ac.uk>).
+
+
+Inquiries can be sent to: <matsd@sssk.se>. You can also visit
+my LaTeX web page at http://www.homenet.se/matsd/latex/
+This file was last modified on 1998/06/01.
+
+
+____________________________________________________________________
+Copyright (c) 1998 by Mats Dahlgren.
+
diff --git a/Master/texmf-dist/doc/latex/floatflt/floatflt.pdf b/Master/texmf-dist/doc/latex/floatflt/floatflt.pdf
new file mode 100644
index 00000000000..62a4492cc0a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/floatflt/floatflt.pdf
Binary files differ