homepage

The current argparse documentation is not easy to read people new to python.
http://docs.python.org/dev/library/argparse.html#choices
{{{
current: parser.add_argument('foo', choices='abc')
}}}
Please make this more explicit:
{{{
better: parser.add_argument('foo', choices=['one', 'two', 'three'])
}}}
{{{
current: parser.parse_args('c'.split()) # looks like perl to me
}}}
{{{
better: parser.parse_args(['c'])
}}}
Next: Please use a more common type, not "complex" in the choices example. It confuses a lot of people.