Clarify how the specify the name of a module with the 'module' directive.
diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
index 05f9c4d..82c75cf 100644
--- a/Doc/documenting/markup.rst
+++ b/Doc/documenting/markup.rst
@@ -53,9 +53,9 @@
.. describe:: module
- This directive marks the beginning of the description of a module (or package
- submodule, in which case the name should be fully qualified, including the
- package name).
+ This directive marks the beginning of the description of a module, package,
+ or submodule. The name should be fully qualified (i.e. including the
+ package name for submodules).
The ``platform`` option, if present, is a comma-separated list of the
platforms on which the module is available (if it is available on all