Setting Version Management Preferences

You can change how Dimensions for Eclipse displays items by modifying your Version Management preferences.

To modify your Version Management preferences:

1. Select Window | Preferences. 

2. Expand the Team | Serena Dimensions node, and select Version Management.

3. Choose from the following:

• Delete unmanaged resources on replace to delete all files in your local workspace when you perform a replace.

• Consider file contents in comparisons to evaluate the contents of two files if the modification time is identical when performing operations.

• Attempt to find common ancestor baseline automatically to have Dimensions CM find the common ancestor for comparisons, instead of having to select it manually.

• Synchronize workspace with home stream on switching to the foreign stream synchronizes your workspace when you switch to a foreign stream and warns you if the local workspace is out of sync with the home stream.

• Preselect project default requests where possible lets the integration select the default requests for projects when you perform team operations.

• Clean timestamps during status update clears the local modification status for any files that have not been changed since they were last retrieved from the repository, but for which the timestamp has been updated (or touched).

• Undo Checkout on checkin of files without changes automatically undoes check-out of any files that are unchanged, when attempting to check in locked files.

• Expand substitution variables expands all substitution variables in source files by default. Avoid using non-reversible substitutions as these will not be removed when you commit changes to the repository.

• Auto share on import automatically shares projects imported into Eclipse with Dimensions CM. For more on this use case, please see Using Existing Eclipse Projects with Shared Work Areas.

4. Under Appearance, choose from the following options:

• Under Save dirty edits before Dimensions operations, determine if Dimensions will automatically save the unsaved updates that you have made before performing the Dimensions source control operation. The options are Never, Prompt, or Auto save.

• Show project and Baseline lists in lets you choose whether to open project and baseline lists in the editor or in the view (which is usually right-bottom and smaller).

• Use multipage layout will cause different lists of projects or baselines to be shown in a single view or editor with tabs at the bottom. If disabled, each has its own view or editor.

• Automatically start Dimensions Context opens the Dimensions Context view whenever you select a project or baseline. See Showing the Dimensions CM Context View for Projects for more information.

• Maximum number of comments to remember specifies the number of entries to remember in the Choose a previously entered comment drop-down list on the Commit Wizard.

5. Optionally, under Auto-merge, choose to have Dimensions for Eclipse attempt to auto-merge all non-conflicting changes when you perform an Update.

6. On the File Modification node under Version Management, you can set how Eclipse responds when you attempt to edit read-only files:

• Select to check out to make writeable, make writeable, or prompt when you attempt to modify a read-only file, which is under Dimensions CM control.

• Select to make writable, or prompt when you attempt to modify a read-only file, which is not under Dimensions CM control.

• Select to make writable, or prompt when you attempt to modify a read-only file, which is checked out from Dimensions CM.

7. Change your Label Decoration preferences by selecting Label Decorations under Version Management:

   Preference	Action
   Show deep status for folders	Shows composite status for the folders. See following note for information about using this setting with the following setting.
   Always show deep status for projects	Shows composite status for the children. NOTE  Always show deep status for projects overrides Show deep status for folders for project nodes if the latter is disabled and causes projects (but not folders) to display cumulative status.
   Show remote info for projects	Shows connection details for a project.
   Show base revision for files	Shows the base revision of the file that was fetched in ().
   Show remote revisions for files	Shows the file is different from remote revision by stating remote revision number in [].
   Show locally modified status as text	Marks locally modified files with a text decoration (>).
   Show locally modified status as image	Marks locally modified files by changing the file icon. The icon contains a pen symbol on the top right.
   Show local mode	Marks files that are in local mode by changing the file icon. The icon contains a wrench.

8. Select the Requests node under Version Management to set the following preferences for handling requests:

• Using work list by default: Choose whether to display your working list of requests or your Dimensions inbox when checking files out and in.

• Show project id on request selection page: This option displays/hides the Project column on the Relate Requests page of the Commit Wizard. This column displays the Dimensions project of each resource.

• Remove from my working list after successful checkin / commit operations: Select this option to remove requests from your working lists after you have successfully checked in or committed files in response to those requests.