乙酸鋰 <ch3co...@gmail.com> writes: > I would like to enhance git-tag documentation > > --Unless -f is given, the tag to be created must not yet exist in the > .git/refs/tags/ directory. > ++Unless -f is given, the tag to be created must not yet exist in the > .git/refs/tags/ directory or inside .git/packed-refs file.
I think the updated text is technically correct, but I do not think it is a good direction to go. The root cause of the problem was that the original text assumed ".git/refs/tags/ directory" will forever be the only way to have a local tag, and the description was left behind when packed refs mechanism was introduced to improve the file system usage. It shouldn't have relied its description on such an implementation detail in the first place. The updated text still shares the same problem. I think the right fix is to say something like this: Unless -f is given, the tag to be created must not yet exist as a local tag. -- 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