Version
The Version command on the menu contains the following commands to manipulate the selected directory or file element.
- Command
- Description
- Checkout
- Creates a modifiable copy of the selected version. See the following.
- Checkin
- Creates a permanent new version. See the following.
- Uncheckout
- Cancels a checkout. See the following.
- Change checkout
- Converts a checkout state. See the following.
- Diff
- Runs Diff Merge Tool. See the following.
- Merge
- Starts a merge. See the following.
- Operates on a merge arrow. See the following.
- Edits the checkout comment associated with the selected version.
- Edits the comment associated with the creation of the selected version.
- Removes each selected version from the version tree of the element.
- Removes from the version tree of the element all versions between (but not including) the two specified versions.
- Locate
- In graphic mode, lets you:
- Scroll to the version selected by the view
- Scroll to the version or branch selected by the mouse pointer
- Specify a criterion to find a version or branch
Checkout prompt for options
Creates a modifiable copy of the selected version (if you select the branch object, checks out the latest version on the branch). The Version Tree Browser displays a Prompt for options window and a VersionVault window. In the VersionVault window, you are asked whether your config spec rules should be used. For example, your view may be set up to create a new branch for this element. Click No and the rules in your config spec are ignored. Click Yes to use the rules.
In the Check Out window, enter your comment, set either Reserved or Unreserved if already reserved, and click OK.
Checkout reserved: no comment
Creates a modifiable copy of the selected version (reserved) and supplies a blank comment. If you select the branch object, the software checks out the latest version on the branch.
Checkout unreserved: no comment
Creates a modifiable copy (unreserved) of the selected version (if you select the branch object, creates a modifiable copy of the latest version on the branch) and supplies a blank comment.
Checkin prompt for options
Creates a permanent new version of the selected element. In the Check In window, edit the comment that you used in checking the file out and click OK.
Checkin reuse checkout comment
Creates a permanent new version of the selected checked-out element, using as the comment the checkout comment that you supplied.
Uncheckout default
Cancels the checkout of the selected object. If the object is a file, you will be prompted about saving the private copy.
Uncheckout keep private file
Cancels the checkout of the selected file and saves any view-private file by renaming it.
Uncheckout remove private file
Cancels the checkout of the selected file and removes the view-private data.
Change checkout unreserved to reserved
Converts an unreserved checkout of the selected version to reserved.
Change checkout reserved to unreserved
Converts a reserved checkout of the selected version to unreserved.
Selected vs. predecessor
Runs the Diff Merge Tool to compare the selected version against its immediate predecessor. If the selected version is checked out, the predecessor is the version from which it was checked out.
Selected vs. other
Runs the Diff Merge Tool to compare the selected version against other versions (for which you are prompted with the Version Tree Browser). The selected version is treated as the new version and the ones picked from the Version Tree Browser are treated as old versions.
Merge from version to branch
Merges from specified versions to the branch of the selected version. The Version Tree Browser prompts you to select the "from" versions. If you have already checked out the "to" version to your view, select the checked-out version; otherwise, select a version and the "to" version is checked out from that branch.
Merge from LATEST to checkedout
Merges to the currently selected checked-out version from the LATEST version on the branch from which it is checked out. This type of merge is needed when you have a checkout and you try to check in a version that is not the latest on the branch; you must merge the LATEST version to your checked-out version before you can check in.
Merge from range to branch
Propagates a range of changes made on some other branch onto the branch of the currently selected object. Unlike a regular merge, only the selected changes are taken, not all the changes on the "from" branch. The "to" branch will be checked out if needed.
Merge from single change to branch
Propagates a specific change made on some other branch onto the branch of the currently selected object. Unlike a regular merge, only the selected change is taken, not all the changes on the "from" branch. The "to" branch is checked out if needed.
Merge arrow create
Creates a merge arrow between two versions. The Version Tree Browser prompts you to select the versions.
Merge arrow describe
Lists information about each selected merge arrow.
Merge arrow remove
Removes the selected merge arrow.