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

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index 44a89f1f972bd840eda567299a051ff40b5b8723..8e01de81dde80fb4082203d4add13ef0bbcb2e45 100644 (file)
--- 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}}