[New-bugs-announce] [issue7404] optparse Documentation References Example Files that do not Exist

Mark Roddy report at bugs.python.org
Sat Nov 28 04:12:46 CET 2009

New submission from Mark Roddy <markroddy at gmail.com>:

In the 'Terminology' section of the optparse module documentation, under
the description of the term 'required option', a reference to example
implementations of this concept are stated to be available in two
example files of the source distribution:

"See examples/required_1.py and examples/required_2.py in the optparse
source distribution for two ways to implement required options with

These two files do not appear to have ever been available with python 
but are found in the original 'Optik' distribution that this module is
derived from.  I am guessing that this is a result of the documentation
being copied when the module was added to the standard library as it
also appears in the Optik documentation almost verbatim:

Suggest the reference to these files:
1) Be removed as to prevent confusion as to their existence/location
2) Be updated to point to the Optik source on source forge
3) Merge the examples in line with the documentation
4) Some other option I have not thought of

assignee: georg.brandl
components: Documentation, Library (Lib)
messages: 95780
nosy: MarkRoddy, georg.brandl
severity: normal
status: open
title: optparse Documentation References Example Files that do not Exist
type: feature request
versions: Python 2.6

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list