# # patch "ChangeLog" # from [253d85e60c0a001987b673b7884424f6be9b7a6f] # to [61257f105281c1958639e4711726f487df5f13e0] # # patch "monotone.texi" # from [874fbe044a630abf6de449c5e39a511e9091db40] # to [b19c0f2cedcd918ffe81dae204ec6ce7e2b924a7] # --- ChangeLog +++ ChangeLog @@ -1,5 +1,9 @@ 2005-07-13 Nathaniel Smith + * monotone.texi (Database): Document kill_tag_locally. + +2005-07-13 Nathaniel Smith + * tests/t_kill_tag_locally.at, tests/t_ambiguous_tags.at: New tests. * testsuite.at: Add them. --- monotone.texi +++ monotone.texi @@ -4425,6 +4425,19 @@ you sync, unless the owners of those databases also delete those certificates locally. address@hidden monotone db kill_tag_locally @var{tag} + +This command ``kills'' a tag by deleting all tag certs with that tag +name. You should consider carefully whether you want to use it, because +it can irrevocably delete important information. It does not modify or +delete any revisions, or any of the other certificates on tagged +revisions; it simply removes all tag certificates with the given name. +As with @command{db kill_rev_locally}, it only deletes the information +from your local database; if there are other databases that you sync +with which have this tag, the tag certificates will reappear when you +sync, unless the owners of those databases also delete those +certificates locally. + @item monotone db execute @var{sql-statement} This is a debugging command which executes @var{sql-statement} against