]> granicus.if.org Git - python/commitdiff
Explain that long options are matched based on a unique prefix rather than
authorFred Drake <fdrake@acm.org>
Mon, 8 Jan 2001 16:05:51 +0000 (16:05 +0000)
committerFred Drake <fdrake@acm.org>
Mon, 8 Jan 2001 16:05:51 +0000 (16:05 +0000)
requiring the whole option to be typed out.

This closes SF bug #126863.

Doc/lib/libgetopt.tex

index 6731c3220a26f45297bbf01a121daf0aa572c4ec..563460b30b55ec1f4a790e27fb72b17964ebc1be 100644 (file)
@@ -29,7 +29,14 @@ recognize, with options that require an argument followed by a colon
 names of the long options which should be supported.  The leading
 \code{'-}\code{-'} characters should not be included in the option
 name.  Long options which require an argument should be followed by an
-equal sign (\character{=}).
+equal sign (\character{=}).  To accept only long options,
+\var{options} should be an empty string.  Long options on the command
+line can be recognized so long as they provide a prefix of the option
+name that matches exactly one of the accepted options.  For example,
+it \var{long_options} is \code{['foo', 'frob']}, the option
+\longprogramopt{fo} will match as \longprogramopt{foo}, but
+\longprogramopt{f} will not match uniquely, so \exception{GetoptError}
+will be raised.
 
 The return value consists of two elements: the first is a list of
 \code{(\var{option}, \var{value})} pairs; the second is the list of