DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(cvs.info.gz) Modifying tags

Info Catalog (cvs.info.gz) Tagging by date/tag (cvs.info.gz) Revisions (cvs.info.gz) Tagging add/remove
 
 4.7 Deleting, moving, and renaming tags
 =======================================
 
 Normally one does not modify tags.  They exist in order to record the
 history of the repository and so deleting them or changing their
 meaning would, generally, not be what you want.
 
    However, there might be cases in which one uses a tag temporarily or
 accidentally puts one in the wrong place.  Therefore, one might delete,
 move, or rename a tag.
 
 *WARNING: the commands in this section are dangerous; they permanently
 discard historical information and it can be difficult or impossible to
 recover from errors.  If you are a CVS administrator, you may consider
 restricting these commands with the `taginfo' file ( taginfo).*
 
    To delete a tag, specify the `-d' option to either `cvs tag' or `cvs
 rtag'.  For example:
 
      cvs rtag -d rel-0-4 tc
 
 deletes the non-branch tag `rel-0-4' from the module `tc'.  In the
 event that branch tags are encountered within the repository with the
 given name, a warning message will be issued and the branch tag will
 not be deleted.  If you are absolutely certain you know what you are
 doing, the `-B' option may be specified to allow deletion of branch
 tags.  In that case, any non-branch tags encountered will trigger
 warnings and will not be deleted.
 
 *WARNING: Moving branch tags is very dangerous!  If you think you need
 the `-B' option, think again and ask your CVS administrator about it
 (if that isn't you).  There is almost certainly another way to
 accomplish what you want to accomplish.*
 
    When we say "move" a tag, we mean to make the same name point to
 different revisions.  For example, the `stable' tag may currently point
 to revision 1.4 of `backend.c' and perhaps we want to make it point to
 revision 1.6.  To move a non-branch tag, specify the `-F' option to
 either `cvs tag' or `cvs rtag'.  For example, the task just mentioned
 might be accomplished as:
 
      cvs tag -r 1.6 -F stable backend.c
 
 If any branch tags are encountered in the repository with the given
 name, a warning is issued and the branch tag is not disturbed.  If you
 are absolutely certain you wish to move the branch tag, the `-B' option
 may be specified.  In that case, non-branch tags encountered with the
 given name are ignored with a warning message.
 
 *WARNING: Moving branch tags is very dangerous!  If you think you need
 the `-B' option, think again and ask your CVS administrator about it
 (if that isn't you).  There is almost certainly another way to
 accomplish what you want to accomplish.*
 
    When we say "rename" a tag, we mean to make a different name point
 to the same revisions as the old tag.  For example, one may have
 misspelled the tag name and want to correct it (hopefully before others
 are relying on the old spelling).  To rename a tag, first create a new
 tag using the `-r' option to `cvs rtag', and then delete the old name.
 (Caution: this method will not work with branch tags.)  This leaves the
 new tag on exactly the same files as the old tag.  For example:
 
      cvs rtag -r old-name-0-4 rel-0-4 tc
      cvs rtag -d old-name-0-4 tc
 
Info Catalog (cvs.info.gz) Tagging by date/tag (cvs.info.gz) Revisions (cvs.info.gz) Tagging add/remove
automatically generated byinfo2html