"Keller, Jacob E" <jacob.e.kel...@intel.com> writes:
> 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?
Yeah, throw that in, too.
... when it begins with `refs/notes/`; when it begins with
`notes/`, `refs/` and otherwise `refs/notes/` is prefixed to
form a full name of the ref.
We could emphasize the end result by ending the sentence like so:
... form a full name of the ref that is under `refs/notes/`.
if you wanted to. I am neutral (I do not think it would hurt, but I
do not think it adds much clarity).
Thanks.
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
