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

[Terry J. Reedy]

Terry J. Reedy <tjreedy at udel.edu> added the comment:

The patch generally changes things like 

:option:`-e`   to   ``-e``   and

-r N/:option:`--repeat=N`   to   ``-r N/--repeat=N``

which is what I understand GB to have said to do.

:program:`python regrtest.py` :option:`test_spam.py`  to
:program:`python regrtest.py test_spam.py`

For the last, I presume that :program:`...` takes the place of ``...``
in the previous examples.

There are a few text changes in doctest.rst that I cannot comment on.

I presume this could and should be backported from 3.2 to other versions. Eli said in email that he has run 'make html' and checked the output.

----------
nosy: +tjreedy
stage:  -> commit review
versions: +Python 2.6, Python 2.7, Python 3.1

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue9312>
_______________________________________