Aw: Re: [PATCH v3 4/4] glossary: improve definitions of refspec and pathspec

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



 
> 
> But I do not know if the description of the longhand ":(top)" is
> unnecessary for the user.  Is the equivalence between it and :/
> described anywhere else in our documentation set?
> 
The only complete "documentation" for all of this is in setup.c and I must
confess that I missed the subtle difference of "magic words" which can be 
used in the long form and "magic signatures" which are used in the short
form. Because currently there is only one "magic *", from a user perspective
I would prefer to document only the short form.
So I suggest to drop the "long form" paragraph entirely and start the 
"short form paragraph" with
"A pathspec that begins with a colon `:` has special meaning.
If the leading colon `:` is followed by zero or more "magic ..."



---
Thomas
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]