summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/floatflt/floatflt.dtx
blob: 6d71bbb2b585d903cf1ca06b7866dcb96028a30f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
%  
%  \iffalse  
% 
%    The first part is a comment to the reader(s) of `floatflt.dtx'.
%
%  floatflt.dtx    Version 1.31.a, June 5, 1998 
%                          1.31.b  20 December 2011
%  (c) 1994-1998 by Mats Dahlgren (see README file for contact address)
%
%  Run LaTeX on the file `floatflt.ins' to get a .sty-file and an
%  example.  For instructions, please run LaTeX on the file
%  `floatflt.dtx' twice.
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
% 
% The Current Maintainer of this work is Mats Dahlgren.
%
% This work consists of the files floatflt.dtx, floatflt.ins and
% README, and the derived files floatflt.sty and floatflt.pdf
%
%<*driver>
\documentclass[a4paper]{ltxdoc}
\textwidth=150mm
\textheight=210mm
\topmargin=0mm
\oddsidemargin=5mm
\evensidemargin=5mm
  \DocInput{floatflt.dtx}
%  \PrintChanges
%\end{document}
%</driver>
%  \fi
%  
%  \CheckSum{787}
%
%  \def\filename{floatflt.dtx}
%  \def\fileversion{1.31}
%  \def\filedate{1997/07/16}
%  \def\docdate{1998/06/05}
%  \date{\docdate}
% \title{Welcome to the \textsf{floatflt} package!\thanks{%
%    This document describes \textsf{floatflt} v.\fileversion{} and
%    was last updated \docdate.}}
% \author{Mats Dahlgren\footnote{Email:\ \texttt{matsd@sssk.se}\ \ \ 
% Web:\ \texttt{http://www.homenet.se/matsd/}}}  
% \begin{document}  
% \maketitle
% 
% \begin{abstract}
% The \textsf{floatflt} package is an extension
% of Thomas Kneser's style option \texttt{floatfig.sty}
% for \LaTeX{} 2.09.  The extension was done by Mats
% Dahlgren (\texttt{mats.dahlgren@madicko.se} http://www.homenet.se/matsd/). 
%
% This file and the package:
% Copyright \copyright{} 1994-1998 by Mats Dahlgren; the whole may
% be distributed under the terms of the LaTeX Project Public Licence,
% Version 1.3c.
% ^^A above details changed 2012-02-29, at mats' request
%
% All rights reserved.
% \end{abstract}
% 
% \section{Introduction}
% The \textsf{floatflt} package defines two environments:
% \texttt{floatingfigure} and \texttt{floatingtable}.  In
% principle the two environments work the same way and do
% the same job, but there are some important differences,
% which are explained below.  The general idea is that a
% figure or table which is not very wide should be allowed
% to have regular text typsetted beside itself.  In Thomas
% Kneser's file \texttt{floatfig.sty} and in the
% documentation thereof, such figures are called
% \textit{floating figures}.  In the \textsf{floatflt}
% package, the term \textit{floating} is generally used
% for such figures and tables, despite the slight
% different use of the term \textit{float} in \LaTeX{}. 
% Hence the term \textit{floating floats} for such figures
% and tables. 
%  
%  This userguide is also available in \texttt{.pdf}-format 
%  on the internet.  It is found from my \LaTeX\ web page: 
%  \texttt{http://www.homenet.se/matsd/latex/}
% 
% \subsection{For \texttt{floatfig.sty} users}
% 
% There are five major differences in the use of
% \textsf{floatflt} as compared to \texttt{floatfig}: 
% \begin{itemize}
% \item The extension to the \texttt{floattable} environment.
% \item There is no longer any need for initialization,
%   thanks to the \verb+\AtBeginDocument+ command. 
% \item Optional arguments for the  environments which 
%   allows the user to place the floating floats left,
%   right or according to   the page number (as with
%   \texttt{floatfig.sty}); this is mainly due to the  
%   possibility to have optional arguments in newly defined
%   environments. 
% \item Optional argument for the package as a whole if
%   the user wants to   force all floating floats to be to
%   the right or left.  The placement   option at
%   \verb+\begin{floatingfigure}+ (and  
%   \verb+\begin{floatingtable}+) overrides this (and there
%   is also the   optional placement option to re-introduce
%   the page-number dependent   placement for one figure or
%   table). 
% \item Compatibility with the \textsf{multicol} 
%   package is now obtained. 
% \end{itemize}
%
% \section{Userguide}
% In the following, the usage of the package is explained
% in some detail.  Users who are unfamiliar with the 
% |floatfig.sty| package by Thomas Kneser may also find it
% useful to run \LaTeX{} on the file |floatfge.tex|.
% 
% \subsection{How to call the package}
% 
% The \textsf{floatflt} package is activated by the
% following line in your \LaTeX\ input file following your
% \verb+\documentclass+ command:\\ \hspace*{5mm}
% \verb+\usepackage[+\textit{option}\verb+]{floatflt}+\\
% The \textit{option} may be either one of the following:
% \texttt{rflt}, \texttt{lflt}, or \texttt{vflt}. 
% 
% \subsubsection{The package options}
% 
% The three package options have the following functions:
% \begin{itemize}
% \item[\texttt{rflt}]  Forces the default for the
%   floating figures and tables to be typset to the right in
%   a paragraph. 
% \item[\texttt{lflt}]  Forces the default for the
%   floating figures and tables to be typset to the left in
%   a paragraph. 
% \item[\texttt{vflt}]  Forces the  floating figures and
%   tables to be typset to the right in a paragraph on
%   odd-nubered pages, and to the left on even-numbered
%   pages; this  is also the default. 
% \end{itemize}
% The option \texttt{vflt} is actually not needed and does
% nothing but tells \LaTeX\ to use the default, it is also
% the internal default. It is supported for symmetry
% reasons with the optional arguments for the environments
% temselves. 
%  
% \subsection{How to use the \texttt{floatingfigure} environment}
%  
% In your \LaTeX\ document you invoke the
% \texttt{floatingfigure} environment by typing:\\ 
% \hspace*{5mm} 
% \verb+\begin{floatingfigure}[+\textit{option}\verb+]{+\textit{width}\verb+}+\\
% \hspace*{5mm} \textit{figure commands with or without} \verb+\caption+\\
% \hspace*{5mm} \verb+\end{floatingfigure}+\\
% The \textit{option} may be either one of the following:
% \texttt{r}, \texttt{l}, \texttt{p}, or \texttt{v}.  The
% quantity \textit{width} is the width you want your
% floating figure to have (such as ``\texttt{75mm}''). 
%   
% \subsubsection{The \texttt{floatingfigure} options}
%   
% The options to the \texttt{floatingfigure} environment
% all overrule any present package option which may be in
% effect.  The options have the following functions: 
% \begin{itemize}
% \item[\texttt{r}]  Forces the current floating figure to
%   be typset to the right in a paragraph. 
% \item[\texttt{l}]  Forces the current floating figure to
%   be typset to the left in a paragraph. 
% \item[\texttt{p}]  Forces the current floating figure to
%   be typset to the right in a paragraph if the pagenumber 
%   is odd, and to the left if even.
% \item[\texttt{v}]  Applies the package option to the
%   current figure, and if no package option is specified,
%   it forces the current floating figure to 
%   be typset to the right in a paragraph if the pagenumber 
%   is odd, and to the left if even.
% \end{itemize}
% The \texttt{p} option is used when the default
% alternating right/left typesetting of floating figures
% is desired despite the use of the \texttt{rflt} or
% \texttt{lflt} package option.  The \texttt{v} option is
% the internal default, and does not have any effect other
% than applying either the default or the option specified
% for the whole package. 
% 
% \subsection{How to use the \texttt{floatingtable} environment}
% 
% In your \LaTeX\ document you invoke the \texttt{floatingtable}
% environment by typing:\\
% \hspace*{5mm} \verb+\begin{floatingtable}[+\textit{option}\verb+]{+\\
% \hspace*{5mm} \verb+\begin{tabular}{+\textit{tabular 
%  specifiers}\verb+}+\\
% \hspace*{5mm}  \textit{here you put your table entries}\\
% \hspace*{5mm} \verb+\end{tabular}}+\\
% \hspace*{5mm} \verb+\caption+ \textit{if desired}\\
% \hspace*{5mm} \verb+\end{floatingtable}+\\
% The \textit{option} may be either one of the following:
% \texttt{r}, \texttt{l}, \texttt{p}, or \texttt{v}.  No
% specification of the width is explicitly made, instead
% \textit{the whole} \texttt{tabular} \textit{environment
% is a mandatory argument}.  Thus, it is important to
% always have the ``\verb+{+'' before
% \verb+\begin{tabular}+ and the ``extra'' ``\verb+}+''
% after \verb+\end{tabular}+.  At the present, the 
% \texttt{tabbing} environment can not be used in the
% \texttt{floatingtable} environment.  (Other commands and
% environments such as the \verb+\parbox+ command may be
% used instead of the \texttt{tabular} environment within
% a \texttt{floatingtable} environment.) 
%   
% \subsubsection{The \texttt{floatingtable} options}
%   
% The options for the \texttt{floatingtable} environment
% are exactly the same as for the \texttt{floatingfigure}
% environment, and they also have the same effects. 
%   
% \subsection{Compatibility}
%     
% The present version of \textsf{floatflt} (v.\fileversion) 
% has been tested
% with \LaTeXe{} of 1997/06/01 using MiK\TeX\ 1.07 running 
% \TeX\ 3.14159 under Win95, using the
% \textsf{article} document class.  Only changes to the
% the documentation has been made since the previous verision. 
%  
%  The
% regular \verb+\caption+ command of both the
% \verb+figure+ and \verb+tabular+ environments work fine.
%  The \verb+\hangcaption+ command of David M.~Jones
% (\texttt{dmjones@theory.lcs.mit.edu}) does not work with
% \textsf{floatflt}.  The use of \verb+\hangcaption+ gives
% the same result as \verb+\caption+.  The listing
% commands \verb+\listoffigures+ and \verb+\listoftables+
% also work properly.  However, since floating figures and
% tables normally are typsetted in a paragraph, the order
% in the lists may be strange if also regular
% \texttt{figure} and \texttt{table} environments are used
% close to the floating ones. 
%   
% Unlike \texttt{floatfig.sty}, \textsf{floatflt} works
% with the \textsf{multicol} package, provided the
% floating floats are still less wide than the columns. 
% If not, or if the floating floats and the columns have
% almost the same width, text may drift away and overlap
% text in adjacent column(s).  However, this combination 
% has several restrictions, and the placement of the
% floating floats may not always be the correct according
% to the page numbering.  Normally it also leads to many
% ''\verb+Underfull \hbox+'' warnings.  The use of this 
% combination is discouraged.
%   
% \subsection{Warnings and messages}
%   
% In Thomas Kneser's original work \texttt{floatfig.sty},
% there are several warnings issued when problems occur. 
% These are kept in \textsf{floatflt}.  Warnings will be 
% issued if two floating figures, two floating tables, 
% or if one floating table is colliding with one floating 
% figure.  Also, message(s)
% will be displayed if a floating float is moved from its
% original paragraph.  Finally, each processed floating
% float will produce a message telling which page it has
% been typsetted on. 
%   
% \section{Known problems and limitations}
%   
% The following problems and limitations are known:
% \begin{itemize}
% \item If a floating figure or table is called close to a
%   sectioning command, the floating float may be lost or
%   truncated.  This may lead to a ``collision warning'',
%   which normally has to be analyzed ``by hand''. 
% \item If two consecutive paragraphs both contain a
%   floating float, a ``collision warning'' is issued.  This
%   warning may be ignored. \item A \texttt{floatingtable}
%   environment  sometimes leads to a warning like:\\
%   \hspace*{5mm} 
% \verb+Overfull \hbox (10.78334pt too wide) in paragraph at lines 287--289+\\
%   where the line numbers refered to are those of the
%   \verb+\end{tabular}+ statement.  This could not be
%   avoided in all cases.   
% \item If you use floating floats of different kinds
%   close to each other in your input, you are likely to
%   have problems.  You may either lose one of the floating
%   floats entirely, have it overwritten by the other, or
%   have it truncated.  
% \item \LaTeX\ has problem in linebreaking short lines. 
%   This may give you bad linebreaks in the captions of
%   floating floats. 
% \item There are some problems when a floating float and a 
%   footnote appear on the same page, especially when the floating
%   float is moved to another page.  Unfortunately, this may
%   need some adjustments by hand.  (Reported by Jakob 
%   Schiotz (\texttt{schiotz@fysik.dtu.dk}).)
% \item If a floating float is placed close to a list environment 
%   (such as \texttt{enumerate} or \texttt{itemize}), the text of the 
%   list environment is likely to overwrite the floating float.  See 
%   section~\ref{LPSoln} below for a semi-automatic solution of this 
%   problem.  (The bug was reported by Rafael Gallego 
%   (\texttt{gallego@esi.us.es}).)
% \end{itemize}
% The first two of these were pointed out by Thomas Kneser
% in the original documentation of \texttt{floatfig.sty}. 
%   
% \subsection{How to Avoid the List Problem}\label{LPSoln} 
%    
% There is a semi-automatic way to avoid the ``List Problem'' 
% mentioned above.  The solution was introduced in version 1.2.  For 
% items in a list which are colliding with a floating float, there is 
% a special command \verb+\fltitem+ avaliable, which takes one mandatory
% argument. This command is to be used in place of the ordinary 
% \verb+\item+, and should have the text of the item as the argument. 
% \textit{E.~g.}\ you would write\\ \hspace*{10mm} 
% \verb+\fltitem{+\textit{text}\verb+}+ \\  instead of \\ 
% \hspace*{10mm} \verb+\item +\textit{text} \\ to avoid the text of 
% the \verb+\item+ command to be written in the floating float.  
% \verb+\fltitem+ also takes a second, optional, argument, which is an 
% extra vertical space put in after the text of the |\fltitem| 
% command.  This is meant to be used specially when there are two 
% paragraphs in the same item text, and the latter is to use the full 
% line width (\textit{i.~e.}\ when the item text ends below the 
% floating float).  So, the full syntax of the |\fltitem| command is:\\ 
% \hspace*{10mm}|\fltitem[|\textit{len}|]{|\textit{text}|}|\\ 
% which inserts the extra vertical space \textit{len} after the item  
% text.  If there is a second text which is to span the full 
% linewidth in the same item, one would write:\\
% \hspace*{10mm}|\fltitem[|\textit{len}|]{|\textit{text1}|} |\textit{text2}\\ 
% which first typesets \textit{text1} narrowed according to the 
% floating float, followed by \textit{text2} with full linewidth, and 
% an extra vertical space \textit{len} between these two texts.
% 
% There is also a second, analogous command 
% |\fltditem| which takes two mandatory and one optional argument.  
% The optional argument is the same as the optional argument of 
% |\fltitem|, the first mandatory argument is the item label, 
% \textit{e.~g.}\ the item to be described in a |description| 
% environment.  The second mandatory argument of |\fltditem| is the 
% item text.  The syntax of the |\fltditem| command is:\\ 
% \hspace*{10mm}|\fltditem[|\textit{len}|]{|\textit{label}|}{|\textit{text}|}|\\
% which produces an item with label \textit{label} and text  
% \textit{text} and extra vertical space \textit{len} after the item  
% text.  Additional text spanning the full linewidth may follow, 
% just like with |\fltitem|, but the indentation may turn out to be 
% strange.
% 
% Both |\fltitem| and |\fltditem| can be used in an ordinary 
% |itemize|, |enumerate|, or |description| environment (however, the 
% use of |\fltditem| in |enumerate| may produce strange results).  For 
% |\fltitem| and |\fltditem| to work properly, the (otherwise) 
% colliding floating float must be set flush right, that is have the 
% option |r| specified.  The use of |\fltitem| or |\fltditem| is not 
% demonstrated in the |floatexm.tex| file.  
%   
% \subsection{Sending a bug report}
%   
% Reports of new bugs in the package are most welcome. 
% However, I do not consider this to be a ``supported''
% package.  This means that there is no guarantee I (or
% anyone else) will put any effort into fixing the bug.  
% But, on the other hand, someone may try debugging, so filing a 
% bug report is always a good thing to do! (If nothing else,
% your discoveries may end up in future releases of this
% document.)  Before filing a bug report,  please take the
% following actions: 
% \begin{enumerate}
% \item Ensure your problem is not due to your inputfile;
% \item Ensure your problem is not due to your own 
%   package(s) or class(es);
% \item Ensure your problem is not covered in the section ``Known
%   problems and limitations'' above;
% \item  Try to locate the problem by writing a minimal \LaTeXe\ 
%   input file which reproduces the problem.  Include the command\\ 
%   \verb+   \setcounter{errorcontextlines}{999}+\\ in your input;
% \item Run your file through \LaTeXe;
% \item Send a description of your problem, the input file and the 
%    log file via e-mail to:\\  \texttt{matsd@sssk.se}.
% \end{enumerate}
%  
% \section{Conclusion}
%  
% Without Thomas Kneser's \texttt{floatfig.sty} as a base,
% I could never have written the \textsf{floatflt}
% package.  I hope that some users will find the package
% useful and not too bugful. :--) Comments and suggestions
% for improvements are always most welcome!\\*[3mm]
% {\itshape Enjoy your \LaTeX!\raisebox{-\baselineskip}[0pt][0pt]{mats d.}} 
%
%  \StopEventually{\par\vfill\hfill{\scriptsize Copyright
%    \copyright{} 1994-1998 by Mats Dahlgren.}} 
% \section{Package code}
%
%  This section prints the package code but without comments.
% \iffalse
%
%<*paketkod>
%  \fi
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[1996/12/01]
\ProvidesPackage{floatflt}[1997/07/16 v. 1.31]
\newcounter{OptionTest}
\setcounter{OptionTest}{0}
\DeclareOption{rflt}{\setcounter{OptionTest}{1}}
\DeclareOption{lflt}{\setcounter{OptionTest}{2}}
\DeclareOption{vflt}{\setcounter{OptionTest}{0}}
\DeclareOption*{\OptionNotUsed}
\ProcessOptions
\newbox\figbox
\newbox\tabbox
\newbox\pagebox
\newcount\ffigcount
\newcount\ftabcount
\newcount\fftest
\newcount\hangcount
\newcount\nosuccesstryfig
\newcount\nosuccesstrytab
\newdimen\figgutter   \figgutter=1truepc
\newdimen\tabgutter   \tabgutter=1truepc
\newdimen\htdone      \htdone=0pt
\newdimen\pageht
\newdimen\startpageht
\newdimen\tabbredd
\newdimen\floatfltwidth
\newdimen\fltitemwidth
\newif\iftryingfig     \tryingfigfalse
\newif\iftryingtab     \tryingtabfalse
\newif\ifdoingfig      \doingfigfalse
\newif\ifdoingtab      \doingtabfalse
\newif\iffigprocessing \figprocessingfalse
\newif\iftabprocessing \tabprocessingfalse
\newif\ifpageafterfig  \pageafterfigfalse
\newif\ifpageaftertab  \pageaftertabfalse
\newif\ifoddpages
\newif\ifoutput
\newtoks\outputpretest
\newenvironment{floatingfigure}[2][v]%
{\@tfor \@tempa :=#1\do
         {\if\@tempa r\global\oddpagestrue\fi
          \if\@tempa l\global\oddpagesfalse\fi
          \if\@tempa p%
              \ifodd\c@page\global\oddpagestrue
                \else\global\oddpagesfalse\fi
          \fi
          \if\@tempa v%
             \ifnum\theOptionTest=0
                 \ifodd\c@page\global\oddpagestrue
                   \else\global\oddpagesfalse\fi
             \else
                  \ifodd\theOptionTest\global\oddpagestrue
                    \else\global\oddpagesfalse\fi
             \fi
          \fi
         }
 \expandafter\ifx\csname oldoutput\endcsname\relax% ref. TeXbook Ex.7.7
    \PackageError{floatflt}{The `floatflt' package is not initialized}
     {Try to reinstall the `floatflt' package.\MessageBreak
      Type `x' to quit or <Return> to try to go on.}\@@end\fi
 \global\everypar={\tryfig\oldeverypar}% must be set globally!
 \global\advance\ffigcount by 1
 \iffigprocessing
    {\count0=\ffigcount\advance\count0 by -1 
     \PackageWarningNoLine{floatflt}{Floating figures \the\count0\space%
       \space and \the\ffigcount\space colliding}%
    }%
 \fi 
 \iftabprocessing \PackageWarningNoLine{floatflt}{Floating figure %
   \the\ffigcount\space and floating table \the\ftabcount\space colliding}
 \fi
 \def\@captype{figure}
 \global\setlength{\floatfltwidth}{#2}
 \global\figprocessingtrue
 \global\setbox\figbox=\vbox\bgroup% begin of figbox
                               \hrule height 0pt width #2 depth 0pt%
                               \hsize=#2%
}
{
\egroup
\figinsert\par%
}
\newenvironment{floatingtable}[2][v]%
{\@tfor \@tempa :=#1\do
         {\if\@tempa r\global\oddpagestrue\fi
          \if\@tempa l\global\oddpagesfalse\fi
          \if\@tempa p%
              \ifodd\c@page\global\oddpagestrue
                \else\global\oddpagesfalse\fi
          \fi
          \if\@tempa v%
             \ifnum \theOptionTest=0
                 \ifodd\c@page\global\oddpagestrue
                   \else\global\oddpagesfalse\fi
             \else
                  \ifodd\theOptionTest\global\oddpagestrue
                    \else\global\oddpagesfalse\fi
             \fi
          \fi
         }
\expandafter\ifx\csname oldoutput\endcsname\relax% ref. TeXbook Ex.7.7
     \PackageError{floatflt}{The `floatflt' package is not initialized}
     {Try to reinstall the `floatflt' package.\MessageBreak
      Type `x' to quit or <Return> to try to go on.}\@@end\fi
\global\setbox\tabbox=\vbox\bgroup\hrule height 0pt width 0pt depth 0pt%
   \hsize=0pt\egroup  
 \global\everypar={\trytab\oldeverypar}
 \global\advance\ftabcount by 1
 \iftabprocessing
    {\count0=\ftabcount\advance\count0 by -1 
     \PackageWarningNoLine{floatflt}{Floating tables \the\count0\space%
            \space and \the\ftabcount \space colliding}%
    }
 \fi 
 \iftabprocessing \PackageWarningNoLine{floatflt}{Floating table %
   \the\ffigcount\space and floating figure \the\ftabcount\space colliding}
 \fi
 \settowidth{\tabbredd}{#2}
 \global\setlength{\floatfltwidth}{\tabbredd}
 \def\@captype{table}
 \global\tabprocessingtrue
 \global\setbox\tabbox=\vbox\bgroup% begin of tabbox
                              \hrule height 0pt width\tabbredd depth 0pt%
                               \hsize=\tabbredd
\noindent\ifnum\ftabcount >1\ifoddpages\else\hspace*{-12pt}\fi\fi%
#2\vspace{0.2\baselineskip}%
}
{
\egroup% end of \tabbox
\tabinsert\par%
}
\AtBeginDocument{%
\edef\oldoutput{\the\output}%
\output={\the\outputpretest%
           \ifoutput\oldoutput\fi}
\outputpretest={\outputtrue}
\edef\oldeverypar{\the\everypar}
}
\def\dofigtest{%
   \ifnum\outputpenalty=-10005
     \setbox\pagebox=\vbox{\unvbox255}%
     \global\pageht=\ht\pagebox
     \global\outputfalse
     \unvbox\pagebox
   \else
     \global\outputtrue
     \ifdoingfig
         \global\pageafterfigtrue
     \fi
   \fi}% 
\def\dotabtest{%
   \ifnum\outputpenalty=-10005
     \setbox\pagebox=\vbox{\unvbox255}%
     \global\pageht=\ht\pagebox
     \global\outputfalse
     \unvbox\pagebox
   \else
     \global\outputtrue
     \ifdoingtab
         \global\pageaftertabtrue
     \fi
   \fi}% 
\def\tryfig{%
      \iftryingfig
       {\everypar={\relax}\setbox0=\lastbox%
       \parindent=\wd0 \parskip=0pt \par% 
       \penalty-10005 \leavevmode}%
       \dimen0=\vsize%
       \advance\dimen0 by -\pageht%
       \advance\dimen0 by -2\baselineskip%
       \ifdim\dimen0>\ht\figbox%
         \dimen0=0.3\baselineskip
         \vrule depth \dimen0 width 0pt
         \vadjust{\kern -\dimen0%
         \vtop to \dimen0{%
             \baselineskip=\dimen0%
             \vss \vbox to 1ex{%
             \ifoddpages%
               \hbox to \hsize{\hss\copy\figbox}% 
             \else% leftsetting
               \hbox to \hsize{\copy\figbox\hss}%
             \fi% \ifodd\count0
             \vss}\null}}%
       \global\tryingfigfalse% 
       \global\doingfigtrue
       \global\startpageht=\pageht
       \global\htdone=0pt
       \dohangf
       \ifnum\nosuccesstryfig>0%
         \typeout{floatflt Message: Flt. fig. \the\ffigcount\space set on page 
             \the\count0, shifted \the\nosuccesstryfig\space par(s) forward.}%
       \else
         \typeout{Package floatflt Message: Floating figure \the\ffigcount
              \space set on page \the\count0}%
       \fi 
     \else
       \global\advance\nosuccesstryfig by 1
     \fi
     \else% 
     \ifdoingfig
       {\everypar={\relax}\setbox0=\lastbox
       \parindent=\wd0 \parskip=0pt \par
         \penalty-10005 \leavevmode}%
    \global\htdone=\pageht
    \global\advance\htdone by -\startpageht
    \ifpageafterfig
      \global\doingfigfalse
    \else
      \dimen0=\ht\figbox%
      \advance\dimen0 by 0.5\baselineskip%
      \ifdim\htdone<\dimen0%
         \dohangf
      \else
         \global\doingfigfalse
      \fi
    \fi
    \ifdoingfig\relax\else\global\figprocessingfalse\fi
  \else
    \global\outputpretest={\outputtrue}%
  \fi
\fi
}
\def\trytab{%
      \iftryingtab% 
       {\everypar={\relax}\setbox0=\lastbox%
       \parindent=\wd0 \parskip=0pt \par% 
       \penalty-10005 \leavevmode}%
       \dimen0=\vsize%
       \advance\dimen0 by -\pageht%
       \advance\dimen0 by -2\baselineskip%
       \ifdim\dimen0>\ht\tabbox%
         \dimen0=0.3\baselineskip
         \vrule depth \dimen0 width 0pt
         \vadjust{\kern -\dimen0%
         \vtop to \dimen0{%
             \baselineskip=\dimen0%
             \vss \vbox to 1ex{%
              \ifoddpages%
               \hbox to \hsize{\hss\copy\tabbox}% 
             \else% leftsetting
               \hbox to \hsize{\copy\tabbox\hss}%
             \fi% \ifodd\count0
             \vss}\null}}%
       \global\tryingtabfalse% 
       \global\doingtabtrue
       \global\startpageht=\pageht
       \global\htdone=0pt
       \dohangt
       \ifnum\nosuccesstrytab>0%
         \typeout{floatflt Message: Flt. tab. \the\ftabcount\space set on page 
             \the\count0, shifted \the\nosuccesstrytab\space par(s) forward.}%
       \else
         \typeout{Package floatflt Message: Floating table \the\ftabcount\space
                  set on page \the\count0}%
       \fi 
     \else
       \global\advance\nosuccesstrytab by 1
     \fi
     \else
     \ifdoingtab
       {\everypar={\relax}\setbox0=\lastbox
       \parindent=\wd0 \parskip=0pt \par
         \penalty-10005 \leavevmode}%
    \global\htdone=\pageht
    \global\advance\htdone by -\startpageht
    \ifpageaftertab
      \global\doingtabfalse
    \else
      \dimen0=\ht\tabbox%
      \advance\dimen0 by 0.5\baselineskip%
      \ifdim\htdone<\dimen0%
         \dohangt
      \else
         \global\doingtabfalse
      \fi
    \fi
    \ifdoingtab\relax\else\global\tabprocessingfalse\fi
  \else
    \global\outputpretest={\outputtrue}%
  \fi
\fi
}
\def\figinsert{%
   \global\nosuccesstryfig=0%
   \global\outputpretest={\dofigtest}%
   \global\tryingfigtrue \global\doingfigfalse%
   \global\pageafterfigfalse}%
\def\tabinsert{%
   \global\nosuccesstrytab=0%
   \global\outputpretest={\dotabtest}%
   \global\tryingtabtrue \global\doingtabfalse%
   \global\pageaftertabfalse}%
\def\dohangf{%
   \dimen0=\ht\figbox%
   \advance\dimen0 by -\htdone%
   \advance\dimen0 by 1.49\baselineskip%
   \hangcount=\dimen0%
   \divide\hangcount by \baselineskip%
   \dimen0=\wd\figbox%
   \advance\dimen0 by \figgutter%
   \ifoddpages%
     \global\hangafter=-\hangcount% placing right
     \global\hangindent=-\dimen0%
   \else% \ifleftsetting
     \global\hangafter=-\hangcount% placing left
     \global\hangindent=\dimen0%
   \fi
}
\def\dohangt{%
   \dimen0=\ht\tabbox%
   \advance\dimen0 by -\htdone%
   \advance\dimen0 by 1.49\baselineskip%
   \hangcount=\dimen0%
   \divide\hangcount by \baselineskip%
   \dimen0=\wd\tabbox%
   \advance\dimen0 by \tabgutter%
   \ifoddpages%
     \global\hangafter=-\hangcount% placing right
     \global\hangindent=-\dimen0%
   \else% \ifleftsetting
     \global\hangafter=-\hangcount% placing left
     \global\hangindent=\dimen0%
   \fi
}
\newcommand{\fltitem}[2][0pt]{\setlength{\fltitemwidth}{\linewidth}%
  \addtolength{\fltitemwidth}{-\floatfltwidth}%
  \addtolength{\fltitemwidth}{-0.5em}%
  \item \parbox[t]{\fltitemwidth}{#2}\\[#1]}
\newcommand{\fltditem}[3][0pt]{\setlength{\fltitemwidth}{\linewidth}%
  \addtolength{\fltitemwidth}{-\floatfltwidth}%
  \addtolength{\fltitemwidth}{-0.5em}%
  \item[#2] \parbox[t]{\fltitemwidth}{#3}\\[#1]}
%    \end{macrocode}
%  \Finale
% \iffalse
%</paketkod>
% \fi
% \end{document}
% \iffalse 
%<*exempelkod>
\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
 
%</exempelkod>
%<exempelkod>\end{document}
%<*gammalkod>
 \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
%</gammalkod>
%<gammalkod> \end{document}
% \fi
%
%  \Finale
%
\endinput