[Python-Dev] :program: markup in .rst documentation

Eli Bendersky eliben at gmail.com
Thu Jul 22 17:25:15 CEST 2010


On Tue, Jul 20, 2010 at 20:34, Éric Araujo <merwok at netwok.org> wrote:
>> Sorry to add the third way to the mix, but shouldn't the recommended
>> way to run a module as a script be python -m modname?  As in
>>
>> $ python -m test.regrtest test_spam
>
> This is true but orthogonal to our problem, which is that
> :program:`python -m thing` is wrong if I understood the doc rightly and
> should be replaced by ``python -m thing``.
>

So, how can a decision be reached on this issue? I'd like to fix the
relevant docs because currently there's a lot of confusion. I will fix
the :program: markup together with all the :option: and :cmdoption:
markup.

Eli


More information about the Python-Dev mailing list