diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
index f85158b163f..618e7dada75 100644
--- a/Doc/documenting/markup.rst
+++ b/Doc/documenting/markup.rst
@@ -212,6 +212,14 @@ The directives are:
 
    Describes a Python bytecode instruction.
 
+.. describe:: cmdoption
+
+   Describes a command line option or switch.  Option argument names should be
+   enclosed in angle brackets.  Example::
+
+      .. cmdoption:: -m <module>
+
+         Run a module as a script.
 
 There is also a generic version of these directives: