bug [ 850238 ] unclear documentation/missing command?

1 files changed, 3 insertions, 3 deletions

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index ebebd91caf..e4b91aca24 100644
--- 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} ---