summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2004-10-18 21:30:40 (GMT)
committerFred Drake <fdrake@acm.org>2004-10-18 21:30:40 (GMT)
commit20a175a34a840c209c30a3970f4a881ae76b6531 (patch)
tree242166fd9dc0a0340229191cf631413e496119da
parent8b94dc6d07eafcacb9c5a646d2c10bda21e19085 (diff)
downloadcpython-20a175a34a840c209c30a3970f4a881ae76b6531.zip
cpython-20a175a34a840c209c30a3970f4a881ae76b6531.tar.gz
cpython-20a175a34a840c209c30a3970f4a881ae76b6531.tar.bz2
made it clear that this isn't a complete reference to
LaTeX-as-used-in-Python-documentation, and added some notes about what's missing
-rw-r--r--Doc/doc/doc.tex37
1 files changed, 35 insertions, 2 deletions
diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index 44a89f1..8e01de8 100644
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -214,7 +214,11 @@ distribution, to create or maintain whole documents or sections.
This section is a brief introduction to \LaTeX{} concepts and
syntax, to provide authors enough information to author documents
- productively without having to become ``\TeX{}nicians.''
+ productively without having to become ``\TeX{}nicians.'' This does
+ not teach everything needed to know about writing \LaTeX{} for
+ Python documentation; many of the standard ``environments'' are not
+ described here (though you will learn how to mark something as an
+ environment).
Perhaps the most important concept to keep in mind while marking up
Python documentation is that while \TeX{} is unstructured, \LaTeX{} was
@@ -445,6 +449,34 @@ This \UNIX\ is also followed by a space.
\end{description}
+ \subsection{Common Environments \label{latex-environments}}
+
+ \LaTeX{} provides a variety of environments even without the
+ additional markup provided by the Python-specific document classes
+ introducted in the next section. The following environments are
+ provided as part of standard \LaTeX{} and are being used in the
+ standard Python documentation; descriptions will be added here as
+ time allows.
+
+\begin{verbatim}
+abstract
+alltt
+description
+displaymath
+document
+enumerate
+figure
+flushleft
+itemize
+list
+math
+quotation
+quote
+sloppypar
+verbatim
+\end{verbatim}
+
+
\section{Document Classes \label{classes}}
Two \LaTeX{} document classes are defined specifically for use with
@@ -480,7 +512,8 @@ This \UNIX\ is also followed by a space.
The Python document classes define a lot of new environments and
macros. This section contains the reference material for these
- facilities.
+ facilities. Documentation for ``standard'' \LaTeX{} constructs is
+ not included here, though they are used in the Python documentation.
\subsection{Markup for the Preamble \label{preamble-info}}