乙酸鋰 <ch3cooli@xxxxxxxxx> 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 majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html