Document the new classdesc* environment, and the previously undocumented

excclassdesc environment.

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index a86c45079de880852c024fa2ec9240e7209cd9af..22757979e5e28307db99f028917bc1f0a4563504 100644 (file)
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -519,9 +519,19 @@ This \UNIX\ is also followed by a space.
       Like \env{datadesc}, but without creating any index entries.
     \end{envdesc}
 
+    \begin{envdesc}{excclassdesc}{\p{name}\p{constructor parameters}}
+      Descibe an exception defined by a class.  \var{constructor
+      parameters} should not include the \var{self} parameter or
+      the parentheses used in the call syntax.  To describe an
+      exception class without describing the parameters to its
+      constructor, use the \env{excdesc} environment.
+    \end{envdesc}
+
     \begin{envdesc}{excdesc}{\p{name}}
       Describe an exception.  This may be either a string exception or
-      a class exception.
+      a class exception.  In the case of class exceptions, the
+      constructor parameters are not described; use \env{excclassdesc}
+      to describe an exception class and its constructor.
     \end{envdesc}
 
     \begin{envdesc}{funcdesc}{\p{name}\p{parameters}}
@@ -547,6 +557,13 @@ This \UNIX\ is also followed by a space.
       the parentheses used in the call syntax.
     \end{envdesc}
 
+    \begin{envdesc}{classdesc*}{\p{name}}
+      Describe a class without describing the constructor.  This can
+      be used to describe classes that are merely containers for
+      attributes or which should never be instantiated or subclassed
+      by user code.
+    \end{envdesc}
+
     \begin{envdesc}{memberdesc}{\op{type name}\p{name}}
       Describe an object data attribute.  The description should
       include information about the type of the data to be expected