From: Angelo Borsotti <angelo.borsotti@gmail.com>
Date: Tue, 09 Oct 2012 23:25:59 GMT
Subject: Re: git checkout error
Message-ID: <CAB9Jk9CZ8d=8ugYs7XHXs84Kj9xJmTHZyZ2J0hU66OBS7YDZTg@mail.gmail.com>
In-Reply-To: <m2lifg7zsj.fsf@igel.home>

Hi Andreas,

>
> -b requires an argument <new_branch>, which you specify as --no-track
> here.  <start_point> is topic, and the rest is interpreted as <paths>.
>
The man page describes --track and --no-track as "options". This is why a
reader thinks that they can be specified in any order.
It is also very counter-intuitive to think that --no-track is <new_branch> and
<start_point> is topic. This is certainly not what the command does with
these data because it creates a new branch whose name is <new_branch> and not
--no-track.

I proposed a small change that clarifies the syntax, but if you prefer
to keep it obscure ...

-Angelo