[Python-checkins] CVS: python/dist/src/Doc/doc doc.tex,1.32,1.33

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/doc
In directory slayer.i.sourceforge.net:/tmp/cvs-serv27147/doc

Modified Files:
	doc.tex 
Log Message:

Add new environments: longtableii, longtableiii, and longtableiv, to
support long tables which might break across page boundaries.  Otherwise
identical to tableii, tableiii, and tableiv.


Index: doc.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/doc/doc.tex,v
retrieving revision 1.32
retrieving revision 1.33
diff -C2 -r1.32 -r1.33
*** doc.tex	2000/09/21 05:26:43	1.32
--- doc.tex	2000/09/21 15:58:01	1.33
***************
*** 781,785 ****
      environment.  These are supported for \var{cols} values of
      \code{ii}, \code{iii}, and \code{iv}.  These environments are all
!     built on top of the \env{tabular} environment.
  
      Note that all tables in the standard Python documentation use
--- 781,786 ----
      environment.  These are supported for \var{cols} values of
      \code{ii}, \code{iii}, and \code{iv}.  These environments are all
!     built on top of the \env{tabular} environment.  Variants based on
!     the \env{longtable} environment are also provided.
  
      Note that all tables in the standard Python documentation use
***************
*** 787,792 ****
      markup for each table.  A general border around the outside of the
      table is not used, but would be the responsibility of the
!     processor.
  
      \begin{envdesc}{tableii}{\p{colspec}\p{col1font}\p{heading1}\p{heading2}}
        Create a two-column table using the \LaTeX{} column specifier
--- 788,802 ----
      markup for each table.  A general border around the outside of the
      table is not used, but would be the responsibility of the
!     processor; the document markup should not include an exterior
!     border.
  
+     The \env{longtable}-based variants of the table environments are
+     formatted with extra space before and after, so should only be
+     used on tables which are long enough that splitting over multiple
+     pages is reasonable; tables with fewer than twenty rows should
+     never by marked using the long flavors of the table environments.
+     The header row is repeated across the top of each part of the
+     table.
+ 
      \begin{envdesc}{tableii}{\p{colspec}\p{col1font}\p{heading1}\p{heading2}}
        Create a two-column table using the \LaTeX{} column specifier
***************
*** 803,808 ****
      \end{envdesc}
  
      \begin{macrodesc}{lineii}{\p{column1}\p{column2}}
!       Create a single table row within a \env{tableii} environment.
        The text for the first column will be generated by applying the
        macro named by the \var{col1font} value when the \env{tableii}
--- 813,825 ----
      \end{envdesc}
  
+     \begin{envdesc}{longtableii}{\unspecified}
+       Like \env{tableii}, but produces a table which may be broken
+       across page boundaries.  The parameters are the same as for
+       \env{tableii}.
+     \end{envdesc}
+ 
      \begin{macrodesc}{lineii}{\p{column1}\p{column2}}
!       Create a single table row within a \env{tableii} or
!       \env{longtableii} environment.
        The text for the first column will be generated by applying the
        macro named by the \var{col1font} value when the \env{tableii}
***************
*** 815,818 ****
--- 832,841 ----
      \end{envdesc}
  
+     \begin{envdesc}{longtableiii}{\unspecified}
+       Like \env{tableiii}, but produces a table which may be broken
+       across page boundaries.  The parameters are the same as for
+       \env{tableiii}.
+     \end{envdesc}
+ 
      \begin{macrodesc}{lineiii}{\p{column1}\p{column2}\p{column3}}
        Like the \macro{lineii} macro, but with a third column.  The
***************
*** 823,826 ****
--- 846,855 ----
        Like the \env{tableiii} environment, but with a fourth column.
        The heading for the fourth column is given by \var{heading4}.
+     \end{envdesc}
+ 
+     \begin{envdesc}{longtableiv}{\unspecified}
+       Like \env{tableiv}, but produces a table which may be broken
+       across page boundaries.  The parameters are the same as for
+       \env{tableiv}.
      \end{envdesc}