Linking Specific Revisions

Each end of a link has an associated start revision and an end revision that determines the range of revisions to which the link applies. The start revision is always fixed at the time of the creation of the link and is set to the first revision on the current branch. The end revision is under the user's control and may be fixed (or pinned), which puts an upper bound on the linked revisions, or floating, which does not. If a link end is pinned, it is always attached to the same version of the linked folder or file. If a link end floats, it moves from revision to revision, as new revisions of the linked folder or item are created.

By default, a link connects the tip revisions of the linked pair. The revisions selected for both links appear as columns on the Link pane.

Determining whether a link is visible on a given item is simple. If any of the revisions between the start and the end revision defined for the link are in the history of the selected item, it is visible. Otherwise, it is not.

In this topic:

Linking to a Tip Revision

To link to a tip revision, do the following:

1. Right-click a folder or item for which you have created a link.

2. Do one of the following:

   • If you selected an item, click the Link tab in the lower pane.
   • If you selected a folder in the Folder Tree, choose Folder Tree > Properties to display the Folder Properties dialog box, and click the Link tab.
3. Select one or more links in the Link pane.

4. Right-click the selected link(s) and choose one of the following options:

Pin Link > To Source Item At Tip	This command pins the link to the tip revision of the source (that is, the folder whose properties you are reviewing or the item selected from the upper pane).
Pin Link > To Target Items At Tip	This command pins the link to the tip revision of the target (that is, the folder or item in the Item column on the Link pane).
Pin Link > To Source And Target Items At Tip	This command pins the link to the tip revisions of both the source and target.
Float Link > To Source Item	This command allows the link to float from tip revision to tip revision of the source as new revisions are created.
Float Link > To Target Items	This command allows the link to float from tip revision to tip revision of the target as new revisions are created.
Float Link > To Source And Target Items	This command allows both the source and the target of the link to float from tip revision to tip revision.

Back to top

Linking to a Specific Revision

To link to a specific revision, do the following:

1. Right-click a folder or item for which you have created a link.

2. Do one of the following:

   • If you selected an item, click the Link tab in the lower pane.
   • If you selected a folder in the Folder Tree, choose Folder Tree > Properties to display the Folder Properties dialog box, and click the Link tab.
3. Select a link.
4. Right-click the selected link and choose Link Properties.

   The Link Properties dialog box opens.

5. Optionally, type a description or comment about the link in the Description or Comment field.

   This text will appear in the Comment or Description column of the Link pane view.

6. Do one of the following in the Source Item group:

   • Click Pin: Displays the Select Version dialog box. Select a specific folder or item revision from the list. This revision number will appear in the Selection Version column of the Link pane view.
   • Click Float: The link is always connected to the tip revision of this item.

7. Do one of the following in the Is Linked to Target Item group:

   • Click Pin: Displays the Item Version dialog box. Select a specific folder or item revision from the list. This revision number will appear in the Item Version column of the Link pane view.
   • Click Float: The link is always connected to the tip revision of this item.
8. Click OK.

Back to top