The Keep command creates a new
version of one or more file
elements. Both the contents of the version and its identity are stored permanently in the AccuRev
repository. For each file you
Keep:
·
AccuRev copies the contents of the file currently in your workspace tree to the associated depot in the repository.
·
AccuRev assigns a version-ID to the new version, consisting of the workspace's name and an integer. For example, the version-ID
In the Details pane of a File Browser that is open on a workspace, select one or more file elements. Then:
·
Click the
Keep toolbar button, or
The Keep dialog appears, which you use to complete the command.
The Keep dialog includes basic options (always visible) and advanced options (visibility controlled by a Basic/Advanced button).
Choosing Enable File Locking places a
lock on the element, to enforce
serial development in
sibling workspaces for that element. This ensures that users in sibling workspaces won't have to
merge 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
The Locks Dialog Box on page 53.
The Keep command does the following:
A new version object is created in the workspace stream. It has a unique
version-ID, such as talon_dvt_mary/13 ("the 13th version of this element created in workspace talon_dvt_mary"). A version object is immutable, and cannot be removed from the repository. The version created by
Keep is termed a
real version, because it represents an actual change to an element.
The file element gets the status flag (kept) in your workspace. It also gets the
(member) flag, indicating that the element is
active in your workspace. (It's possible that the element already had one or both these status flags, from previous activity in your workspace.) If the element previously had
(modified) status, this flag is removed.
The Keep command preserves
content changes only, not
namespace changes. Suppose you edit a file, so that it has
(modified) status, then give it a new name with the
Rename command. The new version that
Rename creates does not record your content changes. The file will still have
(modified) status until you preserve the contents changes with
Keep.