[docs] [issue9312] Fix usage of :option: markup in stdlib ReST docs

Éric Araujo report at bugs.python.org
Sun Nov 21 04:10:52 CET 2010

Éric Araujo <merwok at netwok.org> added the comment:

Thanks for the review.  I agree and committed changes in r86632.

The problem with :option:`-c` is probably that Sphinx wants to find a “.. cmdoption:: -c” joined with the latest program directive it has seen, and thus can’t find the -c defined with a previous program directive.  I fought hard with that, trying :option:`-c <cmdoption-unittest-c>` and :ref:, but no luck.  I finally just used ```` markup.  When #10470 is implemented the two option lists will be merged and I’ll be able to use :option:`-c`.

Georg, it would be nice if you could confirm or infirm my analysis.


Python tracker <report at bugs.python.org>

More information about the docs mailing list