Add Tag

Use this command to add a tag (a named label) to file revisions. This is very useful to mark and later retrieve all files at a certain project state (e.g. when developing applications a certain program version). It also makes understanding changes in the Log window more easy.

Enter a valid tag name in the Tag Name input field. Pressing the ellipsis button allows you to choose a tag from the Tag Browser.

Select Revisions specified by local files to add the tag to those revisions, that your local files have.

Select Latest revisions on main-trunk to (blindly) add the tag to the latest main-trunk-revision of all files in the repository (below the selected directory).

Select Revisions specified by another tag and enter an existing tag to set the new tag at the same revisions. You can use this option to set the tag to all latest revisions in a branch by entering the branch tag. To "rename" tags, first add the new tag to all revisions of the old tag (no branch-tag!) and then remove the old tag from all files in the repository.

Select Revisions specified by a date to tag all (main-trunk) revisions, which existed at a specified date.

Select Check that not modified to ensure that all locally modified files are committed before tagging.

If files in the repository already contain the entered tag, you can determine, what should happen:

Even if you want to tag the files with a new tag, the Tag Browser can be of great value when the tags should follow a common naming scheme, because you often only need to change the version number in the tag name.

Example

To tag the files of program version 1.8, select the existing tag 'version-1_7' from the Tag Browser and change the 7 to 8.