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

[Fred Drake]

Update of /projects/cvsroot/python/dist/src/Doc/doc
In directory seahag.cnri.reston.va.us:/home/fdrake/projects/python/Doc/doc

Modified Files:
	doc.tex 
Log Message:

Elaborate descriptions of \e, \module.

Describe policy on vertical lines in tables.


Index: doc.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/doc/doc.tex,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** doc.tex	2000/04/11 18:52:52	1.18
--- doc.tex	2000/04/11 19:08:30	1.19
***************
*** 421,425 ****
      \begin{macrodesc}{e}{}
        Produces a backslash.  This is convenient in \macro{code} and
!       similar macros.
      \end{macrodesc}
  
--- 421,427 ----
      \begin{macrodesc}{e}{}
        Produces a backslash.  This is convenient in \macro{code} and
!       similar macros, and is only defined there.  The create a
!       backslash in ordinary text (such as the contents of the
!       \macro{file} macro), use the standard \macro{textbackslash} macro.
      \end{macrodesc}
  
***************
*** 492,496 ****
  
      \begin{macrodesc}{module}{\p{name}}
!        The name of a module; a dotted name may be used.
      \end{macrodesc}
  
--- 494,499 ----
  
      \begin{macrodesc}{module}{\p{name}}
!        The name of a module; a dotted name may be used.  This should
!        also be used for package names.
      \end{macrodesc}
  
***************
*** 666,669 ****
--- 669,678 ----
      \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
+     vertical lines between columns, and this must be specified in the
+     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}}