[docs] [issue17232] Improve -O docs

[Ezio Melotti]

Ezio Melotti added the comment:

Terry, do you want to update your patch?

----------
versions:  -Python 3.2

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