[PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Thomas Rast
The commit|object argument is actually not explained anywhere (except implicitly in the description of an unannotated tag). Write a little explanation, in particular to cover the default. Signed-off-by: Thomas Rast tr...@inf.ethz.ch --- Prompted by a question on IRC about the default value. Do

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Junio C Hamano
Thomas Rast tr...@inf.ethz.ch writes: The commit|object argument is actually not explained anywhere (except implicitly in the description of an unannotated tag). Write a little explanation, in particular to cover the default. Signed-off-by: Thomas Rast tr...@inf.ethz.ch --- Prompted by a

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Thomas Rast
Junio C Hamano gits...@pobox.com writes: Thomas Rast tr...@inf.ethz.ch writes: +commit, object:: +The object that the new tag will refer to, usually a commit. +Defaults to HEAD. Shouldn't this be more like this: commit:: object:: Your explanation here... Hmm,

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Junio C Hamano
Thomas Rast tr...@inf.ethz.ch writes: Junio C Hamano gits...@pobox.com writes: Thomas Rast tr...@inf.ethz.ch writes: +commit, object:: + The object that the new tag will refer to, usually a commit. + Defaults to HEAD. Shouldn't this be more like this: commit:: object::

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Yann Droneaud
Hi, Le 03.04.2013 16:27, Thomas Rast a écrit : The commit|object argument is actually not explained anywhere (except implicitly in the description of an unannotated tag). Write a little explanation, in particular to cover the default. +commit, object:: + The object that the new tag

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Thomas Rast
Yann Droneaud ydrone...@opteya.com writes: Hi, Le 03.04.2013 16:27, Thomas Rast a écrit : +commit, object:: +The object that the new tag will refer to, usually a commit. +Defaults to HEAD. Is there any other kind of object that can be tagged ... and what is the purpose of this ?

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Junio C Hamano
Thomas Rast tr...@inf.ethz.ch writes: There are some instances with the comma style: $ git grep ',.*::$' Documentation/*.txt Documentation/blame-options.txt:-L start,end, -L :regex:: Documentation/config.txt:gitcvs.dbuser, gitcvs.dbpass:: Documentation/config.txt:http.lowSpeedLimit,

Re: [PATCH] git-tag(1): we tag HEAD by default

2013-04-03 Thread Junio C Hamano
Thomas Rast tr...@inf.ethz.ch writes: Yann Droneaud ydrone...@opteya.com writes: ... Is there any other kind of object that can be tagged ... and what is the purpose of this ? Any object type, including tags. Signed tags of other tags probably make sense if you want to express extra