From: Jeff King <peff@peff.net>
Date: Mon, 13 Apr 2009 11:09:47 GMT
Subject: Re: [PATCH] builtin-branch - allow deleting a fully specified branch-name
Message-ID: <20090413110947.GA15647@coredump.intra.peff.net>
In-Reply-To: <7vws9ohoa4.fsf@gitster.siamese.dyndns.org>

On Mon, Apr 13, 2009 at 02:54:27AM -0700, Junio C Hamano wrote:

> > I think it would be better in the synopsis to split this into two use
> > cases:
> >
> >   git checkout [<branch>]
> >   git checkout -b <new_branch> [<start_point>]
> >
> > And then explain them as separate definitions.
> 
> I'd agree it would make it much nicer.

A 5-patch series follows which does this and a few other fixups. I think
the result is better.

  1/5 doc: clarify --no-track option
  2/5 doc: refer to tracking configuration as "upstream"
  3/5 doc/checkout: refer to git-branch(1) as appropriate
  4/5 doc/checkout: split checkout and branch creation in synopsis
  5/5 docs/checkout: clarify what "non-branch" means

-Peff