<div dir="ltr"><br><div class="gmail_quote"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div><div class="h5">
&gt; &#39;cmdoption&#39; is a directive, while &#39;option&#39; is inline markup. Therefore I<br>
&gt; wouldn&#39;t say they&#39;re completely similar, just meant for different purposes. Both<br>
&gt; a directive and inline markup is useful for describing &quot;official python<br>
&gt; executable options/flags&quot;. Regarding per-module options, I&#39;m not sure special<br>
&gt; markup is needed at all. So a policy has to be define regarding the correct<br>
&gt; usage of these directives/markups, and probably documented in<br>
&gt; Doc/documenting/markup.rst<br>
<br>
</div></div>I&#39;ve done that now in r82961.<br></blockquote></div><br>As per your recommendation in the updated documentation guide, I have fixed the ReST docs of stdlib modules that used :option:, to use code markup (``) instead. I&#39;ve opened issue 9312 for this and submitted a patch.<br>

<br>Eli<br><br></div>