From: Daniele Segato <daniele.segato@gmail.com>
Date: Thu, 25 Jul 2013 13:48:02 GMT
Subject: Re: git tag usability issue: Lightweight vs Annotated confusion for the end user (ex. git describe default)
Message-ID: <51F12C92.6060200@gmail.com>
In-Reply-To: <7vtxjj66kn.fsf@alter.siamese.dyndns.org>

On 07/24/2013 10:34 PM, Junio C Hamano wrote:
> Daniele Segato <daniele.segato@gmail.com> writes:
>
>> Annotated and Lightweight tags are not the same thing
>> for git and you shouldn't mix them up. Annotated tags are meant for
>> release while lightweight tags are meant to tag random commits.
>
> Nicely explained.
>
> This is one of those "we who worked on Git (not worked "with" Git)
> for a long time _know_ it and do not need it to be explained, and we
> didn't spot that it is not explained in the documentation for new
> people."

Good!

Any change in adding an option to filter tags list by annotated only?


>
> Care to roll a documentation patch (and get a commit count for
> yourself ;-)?

I tried, just sent the patch, hopefully I managed to follow the guide I 
found here: 
http://repo.or.cz/w/git.git?a=blob;f=Documentation/SubmittingPatches;hb=HEAD

As you suggested I removed the "title" line and the reference to git 
describe default.

If I did something wrong please explain me what and I'll fix it

>
> Thanks.

You're Welcome :-)

Cheers,
Daniele Segato