From: Keller, Jacob E <jacob.e.keller@intel.com>
Date: Tue, 22 Sep 2015 21:03:31 GMT
Subject: Re: [PATCH] notes: document behavior of --ref and --notes DWIMery
Message-ID: <1442955811.26280.50.camel@intel.com>
In-Reply-To: <xmqq8u7y2nnq.fsf@gitster.mtv.corp.google.com>

On Tue, 2015-09-22 at 13:40 -0700, Junio C Hamano wrote:
> How about phrasing it totally differently?
> 
> 	The ref specifies the full refname when it begins with
> 	`refs/notes/`; otherwise `ref/notes/` is prefixed to form a
> 	full name of the ref.
> 
> I think that would remove the need to illustrate with concrete
> examples like refs/heads/blah.
> 

Wait, what about the DWIM of notes/<name> goes to refs/notes/<name>..
do we need to explain that here? it might seem that "notes/foo" ends up
as "refs/notes/notes/foo" which is not really what we mean.

Regards,
Jake