The Keep Command

Invoking the Keep Command

The Keep Dialog

Basic Options

Advanced Options

Results of a Keep Operation -- the Details

The Keep command creates a new version A particular revision of an element, reflecting a content change (files only) or a namespace change (files and directories). All versions are originally created in workspaces, and can subsequently be promoted to dynamic streams. The original (workspace) version is termed a 'real version'. Each promotion to a dynamic stream creates a 'virtual version', which serves as an alias for (pointer to) the original real version. of one or more file elements A file or directory that is under AccuRev version control. See version.. Both the contents of the version and its identity are stored permanently in the AccuRev repository The directory tree that stores all software configuration management data managed by AccuRev. This data is maintained by the AccuRev Server, responding to requests made through AccuRev client programs. Users never manipulate the repository directly.. For each file you Keep:

talon_dvt_mary/17

... identifies the 17th version of the file element that was created in the workspace named talon_dvt_mary.

Invoking the Keep Command

In the Details pane of a File Browser that is open on a workspace, select one or more file elements. Then:

The Keep dialog appears, which you use to complete the command.

The Keep Dialog

The Keep dialog includes basic options (always visible) and advanced options (visibility controlled by a Basic/Advanced button).

Basic Options

Comment

You can enter a comment string in the text box. (AccuRev "seeds" the text box with your most recent made during the current AccuRev GUI sessionKeep comment.) The comment string becomes a permanent annotation to the version you're creating.

AccuRev itself does not require a comment, but your organization can establish such a requirement by putting a trigger The AccuRev facility that enables user-defined procedures (trigger scripts) to be performed automatically before or after certain operations take place. on the Keep command.

Advanced Options

Choose File Type

By default, AccuRev determines the element type for the newly created version automatically (text or binary). You can override the default by specifying either of these types or ptext (a variant of text). See AccuRev Element Types.

Choose Lock Type

Choosing Enable File Locking places a lock A control on the file element, requiring (1) users must Anchor the file before editing it, and (2) if a user has Anchor'ed the file, users in sibling workspaces cannot Anchor or edit the file. on the element, to enforce serial development The practice of ensuring that multiple users do not work concurrently on the same version-controlled file. See parallel development. in sibling workspaces Two or more workspaces or streams that have the same parent stream. for that element. This ensures that users in sibling workspaces won't have to merge An operation that combines the contents of two versions (contributors) of the same element. To merge the contents of text files, AccuRev uses a '3-way merge' algorithm: it compares the two files line-by-line with a third file, the version that is the closest common ancestor of the other two. Merging of namespace changes also takes into account the closest common ancestor. their work on this element. The lock remains on the element until you (or someone else) changes this value to Disable File Locking in a subsequent Keep command. See File Locks.

Results of a Keep Operation -- the Details

The Keep command does the following:

Notes (click to view):