summaryrefslogtreecommitdiffstats
path: root/Doc/doc/doc.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-04-11 19:08:30 (GMT)
committerFred Drake <fdrake@acm.org>2000-04-11 19:08:30 (GMT)
commit2b853417769e8b4cc7d7917188490ee9aadc4550 (patch)
tree5de0f4d1ab3637d467deae62eeeb739a0cede2d9 /Doc/doc/doc.tex
parentce44498ba885e9b822af438e0277f75dac7a456a (diff)
downloadcpython-2b853417769e8b4cc7d7917188490ee9aadc4550.zip
cpython-2b853417769e8b4cc7d7917188490ee9aadc4550.tar.gz
cpython-2b853417769e8b4cc7d7917188490ee9aadc4550.tar.bz2
Elaborate descriptions of \e, \module.
Describe policy on vertical lines in tables.
Diffstat (limited to 'Doc/doc/doc.tex')
-rw-r--r--Doc/doc/doc.tex13
1 files changed, 11 insertions, 2 deletions
diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index fc99d9c..05ea40d 100644
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -420,7 +420,9 @@ distribution, to create or maintain whole documents or sections.
\begin{macrodesc}{e}{}
Produces a backslash. This is convenient in \macro{code} and
- similar macros.
+ 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}
\begin{macrodesc}{email}{\p{address}}
@@ -491,7 +493,8 @@ distribution, to create or maintain whole documents or sections.
\end{macrodesc}
\begin{macrodesc}{module}{\p{name}}
- The name of a module; a dotted name may be used.
+ The name of a module; a dotted name may be used. This should
+ also be used for package names.
\end{macrodesc}
\begin{macrodesc}{newsgroup}{\p{name}}
@@ -666,6 +669,12 @@ distribution, to create or maintain whole documents or sections.
\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}}
Create a two-column table using the \LaTeX{} column specifier
\var{colspec}. The column specifier should indicate vertical