The Promote Command

The Promote command sends one or more versions 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. from one stream The AccuRev data structure that implements a configuration of the elements in a particular depot. The configuration of a dynamic stream changes over time; the configuration of a snapshot (static stream) never changes. Each workspace has its own private workspace stream. See workspace, stream hierarchy. to another, making the versions accessible in the destination stream -- and in workspaces and streams below it. A single transaction in the AccuRev depot records the creation of the new version(s) in the destination stream.

The basic use of Promote is to take the private versions that you've created in your workspace stream The private stream that is built into a workspace. All new versions of elements are originally created in workspaces; AccuRev records these versions in workspace streams. and make them public by sending them to the workspace's backing stream (parent stream, basis stream) The stream that is just above a given workspace or stream in a depot's stream hierarchy. The given workspace/stream inherits versions from the backing stream..

Promote can also send versions from a dynamic stream to any other dynamic stream. You can such higher-level promotion using the File Browser or Stream Browser tool. Promoting from a stream to a non-parent ("cross-promotion") requires use of an additional tool, the Change Palette.

Notes (click to view):

Invoking the Promote Command

You can promote versions in several contexts:

Using the Promote Dialog

The Promote dialog provides these command 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 session)Promote comment.) The comment string becomes a permanent annotation to the transaction that creates the new version(s) in the destination stream.

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.

Promote (element list)

(only for direct-promotions to the parent stream -- not for cross-promotions) All the versions you specified are listed in a table. You can deselect individual versions by clearing the checkbox in the table's Promote column. Deselected versions will not be promoted.