bug [ 850238 ] unclear documentation/missing command?
diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index ebebd91..e4b91ac 100644
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -1134,9 +1134,9 @@
\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} ---