The typical use of
Promote is to take private versions in your workspace and make them public by sending them to the workspace’s parent (also referred
to as its backing stream). You can also use
Promote to send versions from one dynamic stream to another. You cannot use Promote to promote to a stream other than a parent.
Effect of Status on Promote
A file’s status affects whether you can promote it:
- You can promote elements from a workspace only if they have a status of
(kept).
- You cannot promote any element if it has a status of
(overlap). In this case, you must merge the version you want to promote with the version in the backing stream. You can then promote
new, merged version.
- The
(underlap) status is similar to
(overlap), an element has changed in your workspace and in the backing stream. With
(underlap), the changes in your workspace version have already been promoted to the backing stream (from another workspace, or from
a stream elsewhere in the depot’s stream hierarchy, for example). You can revert the changes in your workspace, or merge and
promote as with (overlap) elements.