[docs] [issue11176] give more meaningful argument names in argparse documentation

[David Lam]

David Lam added the comment:

here's a patch that covers all but one of the foo/bar/baz examples

it also has fixes for the sample code near the beginning from the review Ezio did 

the one example I didn't do was the "Arguments containing -" part. I guess it felt like changing the names in that example would distract from what it was trying to illustrate there

Anyways, I tried to proofread it so hopefully it reads okay, enjoy enjoy ^^

----------
Added file: http://bugs.python.org/file27030/issue11176.patch

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