[2.7] Clarify nature of parse_args 'args' argument. (GH-3292) (GH-3328)

Patch by Paul.j3.  Includes an unrelated but useful addition to the
optparse porting section.
(cherry picked from commit 0c7983e4adf9604d0ac93757a45d14be06c27696)
1 file changed