git/Documentation/technical/api-parse-options.txt, branch v1.6.3

parseopt: prevent KEEP_UNKNOWN and STOP_AT_NON_OPTION from being used together

2009-03-09T22:32:50Z

As suggested by Junio, disallow the flags PARSE_OPT_KEEP_UNKNOWN and PARSE_OPT_STOP_AT_NON_OPTION to be turned on at the same time, as a value of an unknown option could be mistakenly classified as a non-option, stopping the parser early. E.g.: git cmd --known --unknown value arg0 arg1 The parser should have stopped at "arg0", but it already stops at "value". This patch makes parse_options() die if the two flags are used in combination. Signed-off-by: Rene Scharfe Signed-off-by: Junio C Hamano

parseopt: document KEEP_ARGV0, KEEP_UNKNOWN, NO_INTERNAL_HELP

2009-03-09T22:24:16Z

Signed-off-by: Rene Scharfe Signed-off-by: Junio C Hamano

api-parse-options.txt: Introduce documentation for parse options API

2008-06-23T01:14:58Z

Add some documentation of basics, macros and callback implementation of the parse-options API. Signed-off-by: Stephan Beyer Signed-off-by: Junio C Hamano

Start preparing the API documents.

2007-12-15T06:29:38Z

Most of them are still stubs, but the procedure to build the HTML documentation, maintaining the index and installing the end product are there. I placed names of people who are likely to know the most about the topic in the stub files, so that volunteers will know whom to ask questions as needed. Signed-off-by: Junio C Hamano