From: Michele Ballabio <barra_cuda@katamail.com>
Date: Sun, 22 Jun 2008 12:49:08 GMT
Subject: Re: [PATCH 1/2] api-parse-options.txt: Introduce documentation for parse options API
Message-ID: <200806221449.08307.barra_cuda@katamail.com>
In-Reply-To: <1214092802-8175-1-git-send-email-s-beyer@gmx.net>

On Sunday 22 June 2008, Stephan Beyer wrote:
> +`PARSE_OPT_KEEP_DASHDASH`::
> +       Usually long options (`\--long-opt`) are boiled down to their
> +       short option equivalent, if available.
> +       Using this flag, long options are kept.

No: PARSE_OPT_KEEP_DASHDASH keeps the "--" that usually separates options
from files, as in

	git ls-files [options] -- [files]

i.e. after parsing, the new argv will still contain "--".

> +`OPT__ABBREV(&int_var)`::
> +       Add `\--abbrev [<n>]`.

better:
+       Add `\--abbrev[=<n>]`.

since the <n> is optional.