<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;<br>
&gt; More input on this issue:<br>
&gt;<br>
&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>
<br>
Georg</blockquote><div><br>Georg,<br><br>Your fix indeed clarifies :option:. However, I think that cmdoption could also be made clearer by re-iterating that it is to refer to Python&#39;s own options only, and not to be used for command line options of modules.<br>

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