Minor changes. Explain that for class exceptions, use excdesc but do not

document the constructor parameters.  Need a better way, but this will do
for now.

diff --git a/Doc/templates/module.tex b/Doc/templates/module.tex
index 107848f68b3fe6d3531564a3efed27b7320b3013..33d769d79901de2ba2f35e9b998b3b6634edd97e 100644 (file)
--- a/Doc/templates/module.tex
+++ b/Doc/templates/module.tex
@@ -84,7 +84,7 @@ The \module{spam} module defines the following functions:
 
 \begin{funcdesc}{open}{filename\optional{, mode\optional{, buffersize}}}
 Open the file \var{filename} as a can of Spam.  The optional
-\var{mode} and \var{buffersize} arguments specify the read-write mode
+\var{mode} and \var{buffersize} arguments specify the read/write mode
 (\code{'r'} (default) or \code{'w'}) and the buffer size (default:
 system dependent).
 \end{funcdesc}
@@ -101,7 +101,9 @@ once the \function{open()} function has been called.
 
 % --- 3.3. ---
 % Exceptions are described using a ``excdesc'' block.  This has only
-% one parameter: the exception name.
+% one parameter: the exception name.  Exceptions defined as classes in
+% the source code should be documented using this environment, but
+% constructor parameters must be ommitted.
 
 \begin{excdesc}{error}
 Exception raised when an operation fails for a Spam specific reason.
@@ -129,8 +131,7 @@ failure.
 % an example giving the flavor of the module may be given before the
 % detailed list of functions.)
 
-\subsection{Example}
-\nodename{Spam Example}
+\subsection{Example \label{spam-example}}
 
 The following example demonstrates how to open a can of spam using the
 \module{spam} module.