How tags work in Subversion
If you are having trouble finding out the correct Tag or Branch names to use under Subversion (especially when searching or creating EyeQL queries), the steps on this page will help.
Discovering your Subversion tag and branch structure
- Open a file in your repository using Fisheye. Look for a file that has a long lifetime (for example, your build script).
Look at the 'Tags' section to see examples of tags in your system. There are a few different conventions, but the tags shown will give you clues as to how your repository custodians do things.
A typical tag looks like this:
- Copy the tag(s) you may need from the examples you can see in Fisheye's view.
- Enter the tags exactly as they appear into your EyeQL queries or (Fisheye Search).
- Test the outcome.
Screenshot: Subversion Tags viewed in Fisheye
How tag names are constructed
Hyphens are the default method for separating the tag elements, but tags in your Fisheye instance may be different.
Your tag structure depends on several things:
- The symbolic structure of your repository
- The way your Fisheye instance was set up
- Your organization's convention for naming things in the repository
- The configurable character that separates parts of the tag name.
This can sometimes make it confusing to guess what the tag structure could be, when you are searching in Fisheye or using an EyeQL query. Additionally, the separator between tag elements can be configured as hyphen, colon, or other punctuation marks.
Note that slashes cannot be used in a tag name – these are converted to colons by default. For example if your symbolic setup would give you a tag name like the following:
then your tag should look like this:
For more information, see SVN tag and branch structure.