Re: [PATCH] notes: document behavior of --ref and --notes DWIMery
- From
Keller, Jacob E <jacob.e.keller@intel.com>
- Date
- Sep 22, 2015, 21:03 UTC
- 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:
Show 9 quoted lines
> 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