backport bug [ 850238 ] unclear documentation/missing command?

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index d16c414616c28e3a7bb482f61344964c8c3b74b3..d9da0031a84540c58390611c222621b76b6b912e 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} ---