bug [ 850238 ] unclear documentation/missing command?

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index ebebd91cafc7cf86caae74e5058ee798d59a174d..e4b91aca245ea30f65f9a366805d600694f3a762 100644 (file)
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -1134,9 +1134,9 @@ verbatim
   \subsection{Module-specific Markup \label{module-markup}}
 
   The markup described in this section is used to provide information
-  about a module being documented.  A typical use of this markup
-  appears at the top of the section used to document a module.  A
-  typical example might look like this:
+  about a module being documented.  Each module should be documented
+  in its own \macro{section}.  A typical use of this markup
+  appears at the top of that section and might look like this:
 
 \begin{verbatim}
 \section{\module{spam} ---