From: Wayne Davison <wayne@opencoder.net>
Date: Tue, 18 Dec 2007 02:00:42 GMT
Subject: Re: [PATCH 5/7] parse-options: Add a gitcli(5) man page.
Message-ID: <20071218020042.GA9044@blorf.net>
In-Reply-To: <1197915797-30679-6-git-send-email-madcoder@debian.org>

On Mon, Dec 17, 2007 at 07:23:15PM +0100, Pierre Habouzit wrote:
> + * when a command line option takes an argument, use the 'sticked' form.

A minor issue:  the word "sticked" reads very strangely to me (in this
spot and several others in your text).  I think something like joined or
attached (or even abutted) would be better, as seen in this altered text
for the spot cited above (with a few other improvements thrown in):

 * when a command line option takes an argument, it is best to use the
   'joined' form.  In other words, write `"git foo -oArg"` instead of
   `"git foo -o Arg"` for short options, and `"git foo --long-opt=Arg"`
   instead of `"git foo --long-opt Arg"` for long options.  If an option
   takes an optional option-argument, it MUST be written using the
   'joined' form when providing the option-argument.

..wayne..