When "declaring" a module using \*modindex{}, and * doesn't start with "ref",

set up the indexsubitem to "(in module #1)" automatically.  This reduces the
amount of markup needed in the module docs and, more importantly, makes it
o.k. to leave out in simple sections.  \setindexsubitem{} can still be used
to change or reset it.

diff --git a/Doc/myformat.sty b/Doc/myformat.sty
index ef194a44a3d42428fbf9bfd0609c51b570d56c6d..e7d849949ed02e2b9e5699467bffad7443336495 100644 (file)
--- a/Doc/myformat.sty
+++ b/Doc/myformat.sty
@@ -275,6 +275,7 @@
 % Add the defining entry for a module
 \newcommand{\defmodindex}[2]{%
   \index{#1@{\idxcode{#1}} (#2module)|textbf}%
+  \setindexsubitem{(in module #1)}%
   \write\modindexfile{#1 \thepage}}
 
 % built-in & Python modules in the main distribution
@@ -616,3 +617,10 @@
 
 % Tell TeX about pathological hyphenation cases:
 \hyphenation{Base-HTTP-Re-quest-Hand-ler}
+
+% Don't use this at this time.
+% Should probably do a little more, and will get moved around as the
+% document classes get defined.
+\newenvironment{howto}{
+  \chapter{\@title}
+}{}