[docs] [issue15258] argparse documentation: Improve optparse section regarding allow_interspersed_args

[Terry J. Reedy]

Changes by Terry J. Reedy <tjreedy at udel.edu>:


----------
versions:  -Python 3.1

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