home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fonts 1 / freshfonts1.bin / programs / amiga / pastex / macros / distribs / array / longtable.doc < prev    next >
Text File  |  1992-10-11  |  50KB  |  1,440 lines
  1.  
  2. % \iffalse
  3. %
  4. % This file is part of the array package.
  5. % ---------------------------------------
  6. %
  7. % This file was contributed. In case of error please inform the
  8. % original author.
  9. %
  10. % \fi
  11.  
  12. %\iffalse
  13. %%% ====================================================================
  14. %%%  @LaTeX-style-file{
  15. %%%     filename        = "longtable.sty",
  16. %%%     version         = "3.04",
  17. %%%     date            = "12 October 1992",
  18. %%%     time            = "11:51:56 BST",
  19. %%%     author          = "David Carlisle",
  20. %%%     address         = "Computer Science Department
  21. %%%                        Manchester University
  22. %%%                        Oxford Road
  23. %%%                        Manchester
  24. %%%                        England
  25. %%%                        M13 9PL",
  26. %%%     telephone       = "+44 61 275 6139",
  27. %%%     FAX             = "+44 61 275 6236",
  28. %%%     checksum        = "08304 1428 6676 49483",
  29. %%%     email           = "carlisle@cs.man.ac.uk (Internet)",
  30. %%%     codetable       = "ISO/ASCII",
  31. %%%     keywords        = "LaTeX, array, tabular, page",
  32. %%%     supported       = "yes",
  33. %%%     docstring       = "
  34. %%%
  35. %%%     longtable.sty
  36. %%%
  37. %%%     A LaTeX style option defining a multi-page version of tabular.
  38. %%%
  39. %%%     The checksum field above was produced by
  40. %%%     Robert Solovay's checksum utility.",
  41. %%%  }
  42. %%% ====================================================================
  43.  
  44. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  45. %
  46. % Version 1 20-Dec-1990
  47. %
  48. % Version 2 17-June-1991
  49. %
  50. %  *  Works with the New Font Selection Scheme.
  51. %  *  Works with Mittelbach's array.sty.
  52. %
  53. % Version 3 16-March-1992
  54. %
  55. %  *  New implementation. longtables may now start anywhere on the page.
  56. %  *  The code is now self-documenting, using Mittelbach's doc.sty.
  57. %
  58. % Version 3.01 6-April-1992
  59. %
  60. %  *  (Michel Goossens) If a chunk ends on a line in which the first
  61. %     entry is empty, wierd errors occur. Added special begin and end
  62. %     groups, ({\ifnum0=`}\fi) stuff as  explained in Appendix D.
  63. %
  64. % Version 3.02 9-April-1992
  65. %
  66. %  *  (Michel Goossens) Longtable fails if the table counter is reset
  67. %     during a document. Now use an internal counter, but still
  68. %     increment table so \caption and \label work out right.
  69. %
  70. % Version 3.03 25-June-1992
  71. %
  72. %  *  Add \@ifundefined{reset@font} so that the documentation may be
  73. %     processed with old versions of LaTeX.
  74. %  *  Modify the treatment of \d@llar to match the new versions of
  75. %     Mittelbach's array.sty (array.sty v2.0h)
  76. %  *  Added the standard file header proposed by Nelson Beebe
  77. %
  78. % Version 3.04 12-October-1992
  79. %
  80. %  *  (Jean-Pierre Drucbert) Longtable failed when used with
  81. %     \includeonly. Fixed by replacing the \newcount\LT@tables by
  82. %     \newcounter{LT@tables} as LaTeX counters are correctly preserved
  83. %     by \include. (This bug was introduced in V3.02, as previously the
  84. %     LaTeX counter `table' was used.)
  85. %  *  Fix bug which stopped \kill working correctly in headings.
  86. %  *  (Graham Gough) Made \setlongtables issue a warning message.
  87. %  *  (Sebastian Rahtz) longtable ran out of memory on really long
  88. %     tables. Another bug introduced in V3! I had forgotten to call \par
  89. %     to force the page-breaker to consider page breaks after every
  90. %     chunk.
  91. %
  92. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  93. %\fi
  94. %
  95. \def\fileversion{v3.04}
  96. \def\filedate{92/10/12}
  97. \def\docdate {92/10/12}
  98. %
  99. % \CheckSum{863}
  100. % \CharacterTable
  101. %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
  102. %   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
  103. %   Digits        \0\1\2\3\4\5\6\7\8\9
  104. %   Exclamation   \!     Double quote  \"     Hash (number) \#
  105. %   Dollar        \$     Percent       \%     Ampersand     \&
  106. %   Acute accent  \'     Left paren    \(     Right paren   \)
  107. %   Asterisk      \*     Plus          \+     Comma         \,
  108. %   Minus         \-     Point         \.     Solidus       \/
  109. %   Colon         \:     Semicolon     \;     Less than     \<
  110. %   Equals        \=     Greater than  \>     Question mark \?
  111. %   Commercial at \@     Left bracket  \[     Backslash     \\
  112. %   Right bracket \]     Circumflex    \^     Underscore    \_
  113. %   Grave accent  \`     Left brace    \{     Vertical bar  \|
  114. %   Right brace   \}     Tilde         \~}
  115. %
  116. %
  117. %
  118. % \makeatletter
  119. % \@ifundefined{reset@font}{}{}
  120. % \def\@oddfoot{\reset@font\rm\dotfill Page \thepage\dotfill}
  121. % \def\@oddhead{\dotfill{\reset@font\tt longtable.sty}\dotfill}
  122. % \def\ps@titlepage{\let\@oddhead\@empty}
  123. % \makeatother
  124. %
  125. %
  126. % \LTleft=\parindent
  127. % \LTright=\fill
  128. % \LTchunksize=10
  129. %
  130. % \title{longtable.sty\thanks
  131. %   {Version \fileversion, revised \filedate, documentation dated
  132. %   \docdate}}
  133. % \author{D. P. Carlisle}
  134. % \date{12 October 1992}
  135. %
  136. %
  137. % \maketitle
  138. %
  139. % \begin{abstract}
  140. %  This style defines the {\tt longtable} environment, a multi-page
  141. %  version of {\tt tabular}.
  142. % \end{abstract}
  143. %
  144. % ^^A \vbox to 100pt makes the page breaks the same on the first run.
  145. % \vbox to 100pt{\listoftables\vss}
  146. %
  147. % \section{Introduction}
  148. %
  149. % {\tt longtable.sty} defines a new environment, \DescribeEnv{longtable}
  150. % {\tt longtable}, which has most of the features of the {\tt tabular}
  151. % environment, but produces tables which may be broken by \TeX's
  152. % standard page-breaking algorithm. It also shares some features with
  153. % the {\tt table} environment. In particular it uses the same counter,
  154. % {\tt table}, and has a similar "\caption" command. Also, the standard
  155. % "\listoftables" command lists tables produced by either the {\tt
  156. % table} or {\tt longtable} environments.
  157. %
  158. % The following example uses most of the features of the {\tt longtable}
  159. % environment. An edited listing of the input for this example appears
  160. % in Section~\ref{listing}.
  161. %
  162. % \begin{longtable}{@{*}r||p{1in}@{*}}
  163. % KILLED & LINE!!!! \kill
  164. % \caption[An optional caption (for the list of tables)]{A long
  165. % table\label{long}}\\
  166. % \hline\hline
  167. % \multicolumn{2}{@{*}c@{*}}%
  168. %      {This part appears at the top of the table}\\
  169. % \sc First&\sc Second\\
  170. % \hline\hline
  171. % \endfirsthead
  172. % \caption[]{(continued)}\\
  173. % \hline\hline
  174. % \multicolumn{2}{@{*}c@{*}}%
  175. %       {This part appears at the top of every other page}\\
  176. % \bf First&\bf Second\\
  177. % \hline\hline
  178. % \endhead
  179. % \hline
  180. % This goes at the&bottom.\\
  181. % \hline
  182. % \endfoot
  183. % \hline
  184. % These lines will&appear\\
  185. % in place of the & usual foot\\
  186. % at the end& of the table\\
  187. % \hline
  188. % \endlastfoot
  189. % {\tt longtable}  columns  are specified& in the \\
  190. % same way as  in the {\tt tabular}& environment.\\
  191. % "@{*}r||p{1in}@{*}"& in this case.\\
  192. % Each row ends with a& "\\" command.\\
  193. % The "\\"  command  has an& optional\\
  194. % argument, just as in& the\\
  195. %  {\tt tabular}&environment.\\[10pt]
  196. % See the  effect  of "\\[10pt]"&?\\
  197. % Lots of lines& like this.\\
  198. % Lots of lines& like this.\\
  199. % Lots of lines& like this.\\
  200. % Lots of lines& like this.\\
  201. % Also  "\hline"  may be used,&  as in {\tt tabular}.\\
  202. % \hline
  203. % That  was a "\hline"&.\\
  204. % \hline\hline
  205. % That  was "\hline\hline"&.\\
  206. % \multicolumn{2}{||c||}%
  207. % {This is a \tt\char`\\multicolumn\char`{2\char`}\char`{||c||\char`}}\\
  208. % If a  page break  occurs at a "\hline" then& a line is drawn\\
  209. % at the bottom of one  page  and at the& top of the next.\\
  210. % \hline
  211. % The  "[t] [b] [c]"  argument of {\tt tabular}& can  not be used.\\
  212. % The optional argument may be  one of& "[l] [r] [c]"\\
  213. % to specify whether  the  table  should be& adjusted\\
  214. % to the  left, right& or centrally.\\
  215. % \hline\hline
  216. % Some lines may take up a lot of space, like this: &
  217. %     \begin{flushright} This last column is a ``p'' column so this
  218. %     ``row'' of the table can take up several lines. Note however that
  219. %     \TeX\ will  never break a page within such a row. Page breaks only
  220. %     occur between rows of the table or at "\hline" commands.
  221. %     \end{flushright}\\
  222. % Lots of lines& like this.\\
  223. % Lots of lines& like this.\\
  224. % Lots of lines& like this.\\
  225. % Lots of lines& like this.\\
  226. % Lots of lines& like this.\\
  227. % Lots of lines& like this.\\
  228. % Lots of lines& like this.\\
  229. % Lots of lines& like this.\\
  230. % Lots of lines& like this.\\
  231. % Lots of lines& like this.\\
  232. % Lots of lines& like this.\\
  233. % Lots o