@@ -133,10 +133,16 @@ use "--tag-name-filter cat" to simply update the tags. In this
133133case, be very careful and make sure you have the old tags
134134backed up in case the conversion has run afoul.
135135+
136- Note that there is currently no support for proper rewriting of
137- tag objects; in layman terms, if the tag has a message or signature
138- attached, the rewritten tag won't have it. Sorry. (It is by
139- definition impossible to preserve signatures at any rate.)
136+ Nearly proper rewriting of tag objects is supported. If the tag has
137+ a message attached, a new tag object will be created with the same message,
138+ author, and timestamp. If the tag has a signature attached, the
139+ signature will be stripped. It is by definition impossible to preserve
140+ signatures. The reason this is "nearly" proper, is because ideally if
141+ the tag did not change (points to the same object, has the same name, etc.)
142+ it should retain any signature. That is not the case, signatures will always
143+ be removed, buyer beware. There is also no support for changing the
144+ author or timestamp (or the tag message for that matter). Tags which point
145+ to other tags will be rewritten to point to the underlying commit.
140146
141147--subdirectory-filter <directory>::
142148 Only look at the history which touches the given subdirectory.
0 commit comments