AccuRev Preferences
(Tools > Preferences Command)

General Page

Diff/Merge Page

Version Browser Page

Stream Browser Page

The Tools > Preferences command opens a tabbed dialog, in which you can manage a set of parameters that influence the way the AccuRev looks and works. The preferences you set here apply only to you. They are stored in file preferences.xml, in subdirectory .accurev of your home directory. (By default, AccuRev determines your home directory by making a call to the operating system. If environment variable ACCUREV_HOME is set, AccuRev uses the value of this variable as your home directory.)

General Page

Enable Issue Preview

Controls the automatic inclusion of an Edit Form pane below the Query Results pane in a AccuWork Queries tab. The contents of the issue record that is currently selected in the Query Results pane is automatically displayed in the Edit Form pane.

The toolbar of the Query Results pane includes a Show Issue Form button, which toggles the inclusion of the Edit Form pane.

Despite the name "Preview", the Edit Form pane is fully functional: you can revise, save, and export the contents of issue records in this pane.

Show Progress Log

Controls whether the Update or Update Preview dialog includes a scrollable text field that displays the names of up to 2000 elements that are being updated (or would be updated).

If this option is checked, the dialog looks like this:

If this option is cleared, the dialog looks like this:

After the command finishes its work, a complete log is always available, through the View Full Log button in the dialog.

Show External Elements

Controls whether the File Browser's Details pane includes files and directories that have not been placed under version control (Add to Depot command). This setting applies only when you're working in the Folders pane.

Confirm On Exit

Controls whether the AccuRev GUI prompts for confirmation when you invoke the File > Exit command or attempt to shut the GUI window.

Require Manual Refresh

If this preference is cleared, the data displayed on a "buried" GUI tab is automatically refreshed, if necessary, when you switch to that tab. The AccuRev GUI signals that a refresh is necessary with a "refresh" icon next to the tab title.

If this preference is checked, the data on a "buried" tab is not refreshed automatically when you switch to it. Use the View > Refresh command (or function key F5) to refresh the data.

Keep Session Active

Controls whether the session file in the .accurev subdirectory of your home directory will be deleted when you end the AccuRev GUI session. This file is created by the Tools > Login command, and is used by other AccuRev commands to establish your identity (and the identity of your client machine).

Use Ignore Element Optimization

Causes the Update command to use the same pathname optimization that is used by certain File Browser searches.

Update Resolves Trivial Merges

Enables the Update command to perform a merge operation on text file elements that are not in a workspace's default group, but have (overlap)(modified) status. The merges are performed and the Update proceeds only if for all such files, the merge is completely automatic (there are no conflicting change The situation in which both contributors to a merge operation differ from the closest common ancestor at the same text line (or set of lines). Also, the situation in which both contributors have pathnames that differ from the closest common ancestor, and from each other.s).

Display of element name in tables

Controls how element pathnames are displayed in tables: in a single Element column, or in separate Name and In Folder columns.

Online Help Browser

The full pathname of the Web browser to be used for displaying the GUI’s context-sensitive help screens.

Diff/Merge Page

Diff

Specifies the graphical file-comparison tool to be invoked by the GUI's Diff command. You can choose AccuRev's own tool or one of the supported third-party tools from the combo-box. Alternatively, you can type a command line to be executed when the Diff command is invoked. This command line must include substitution patterns:

%1%  Quoted pathname of the first version to be compared.

%2%  Quoted pathname of the second version to be compared.

%3%   Unquoted title string for the first version (can be displayed by file-comparison tool).

%4%  Unquoted title string for the second version (can be displayed by file-comparison tool).

Make sure the file-comparison tool  is located in a directory on your search path. Alternatively, use a full pathname to specify the file-comparison tool. Examples:

MyDiff /G %1% %2%

C:\SuperCompare\SCgui %1% %2%

Notes (click to view):

Merge

Specifies the graphical text-file merge tool by be invoked by the GUI's Merge command. This command line must include substitution patterns:

%a%  quoted filename of the closest common ancestor version.

%1%  quoted filename of the version in the backing stream, or other non-workspace version.

%2%  quoted filename of the version in the workspace.

%3%  unquoted title string for the closest common ancestor version (can be displayed by text-file-merge tool).

%4%  unquoted title string for the backing-stream version (can be displayed by text-file-merge tool).

%5%  unquoted title string for the workspace version (can be displayed by text-file-merge tool).

%o%  quoted name of the merge-output file -- a temporary file for storing the results of the merge.

Make sure the text-file-merge tool  is located in a directory on your search path. Alternatively, use a full pathname to specify the text-file-merge tool.

Notes (click to view):

Tab size

(AccuRev's graphical Diff and Merge tools only) The number of spaces to be displayed for each TAB character.

Character Encoding

(AccuRev's graphical Diff and Merge tools only) Specifies the character encoding of the contributor versions: either UTF-8 or the operating system default.

Ignore Whitespace

(AccuRev's graphical Diff and Merge tools only) Controls whether whitespace is taken into account when comparing text lines.

Ignore Changes in Whitespace

(AccuRev's graphical Diff and Merge tools only) Controls whether a change in the amount of whitespace in a text line is considered to be a change to that line.

Ignore Case

(AccuRev's graphical Diff and Merge tools only) Controls whether uppercase and lowercase characters are considered to be the same when comparing text lines.

Version Browser Page

Initial display mode

Specifies the mode that a new Version Browser tab begins in. Basic mode displays "important" versions only, for example omitting intermediate versions in workspace streams. Expanded mode displays all versions. Buttons at the bottom of the Version Browser tab switch between the two display modes.

Initial transaction count

How many of the most recent transactions (and equivalently, versions) a new Version Browser should display. Controls in the Version Browser toolbar change this count.

Stream Browser Page

Display Default Group in Stream Browser

Controls whether the Stream Browser includes a current development activity control ( or or ) for each stream and workspace with active An element is said to be active in a workspace or stream if a new version of the element has been created there, and that version has not been either (1) promoted to the parent stream or (2) purged from the workspace or stream. See default group, backed, passive. An issue record is said to be active in a workspace or stream if the head version of one or more of its change package entries is in the stream's default group. elements. Disabling this feature can significantly improve Stream Browser performance.

Enable Stream Browser History

Controls the inclusion in the Stream Browser toolbar of controls that enable you to "turn back the clock", viewing a depot's stream hierarchy as it existed at any point in the past. You must refresh any existing Stream Browser tabs to make a new setting effective.