[New-bugs-announce] [issue14034] the example in argparse doc is too complex

Tshepang Lekhonkhobe report at bugs.python.org
Thu Feb 16 19:34:22 CET 2012

New submission from Tshepang Lekhonkhobe <tshepang at gmail.com>:

The argparse example (http://docs.python.org/dev/library/argparse.html#example) introduces way too many concepts too early. It's written as if targeted to existing users of optparse, instead of newcomers to Python's CLI handling.

Perhaps the example could be more gentle, or if there is insistence on showing off, maybe the page could be kept as-is, but with a link to some tutorial (as is done with logging: http://docs.python.org/dev/library/logging.html).

assignee: docs at python
components: Documentation
messages: 153491
nosy: docs at python, tshepang
priority: normal
severity: normal
status: open
title: the example in argparse doc is too complex
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list