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

Éric Araujo report at bugs.python.org
Sat Aug 7 16:15:48 CEST 2010

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

Nice changes! Especially the program/cmdoption directives combo.

Your patch introduces trailing whitespace (good editor settings can show those, as well as hg diff with the color extension) and has one unnecessary change:

-line, ``options.filename`` will be ``"outfile"`` and ``options.verbose`` will be
+line, ``options.filename`` will be ``outfile`` and ``options.verbose`` will be

In this case, the things in ```` are not command line snippets but Python code, so the quotes are regular string notation.

Attached patch fixes that.

Added file: http://bugs.python.org/file18425/issue9312.3.patch

Python tracker <report at bugs.python.org>

More information about the docs mailing list