27.01.2015 Views

CLI User's Guide - AccuRev

CLI User's Guide - AccuRev

CLI User's Guide - AccuRev

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

• (dynamic stream only) There are one or more defunct elements at a given pathname, along<br />

with one non-defunct element. The defunct element(s) have (stranded) status.<br />

• The element’s directory (or a higher-level directory) is cross-linked, making another<br />

version appear at the pathname of the active version.<br />

Changes to the element in the workspace:<br />

• (modified) — the file has been modified in the workspace since the most recent update or<br />

keep. See Optimized Search for Modified Files: the Scan Threshold on page 237.<br />

• (kept) — a new version of the element has been created with keep, move, defunct, or<br />

undefunct, and the file has not subsequently been modified, promote’d to the backing stream,<br />

or purge’d.<br />

• (member) — the element is “active” in the workspace (is in the workspace stream’s default<br />

group). The commands that create a new version, listed above, also make the element active.<br />

So do the commands merge and revert, which invoke the keep command. And so do the<br />

commands anchor and co, which make an element active by creating a virtual version in the<br />

workspace.<br />

Relationship to the version in the backing stream:<br />

• (backed) — the version in the workspace stream is the same as the version in the backing<br />

stream. And you have not changed the element since the last time you promote’d or purge’d<br />

it, or since the most recent update of your workspace.<br />

• (stale) — the element needs to be updated, because the version in the backing stream has<br />

changed since the workspace’s latest update. And since you have not changed the element in<br />

your workspace, it can be safely updated.<br />

• (overlap) — the element has changed both in the backing stream and in your workspace. This<br />

indicates that a merge is required before you can promote your changes to the backing stream.<br />

Prior to <strong>AccuRev</strong> 4.6, “underlap” files were considered to have “overlap” status.<br />

• (underlap) — similar to overlap: the element has changed both in the backing stream and in<br />

your workspace, but the changes in your workspace have already been promoted to the<br />

backing stream. (More precisely, your version is an ancestor of the backing stream’s version.)<br />

In many cases, no promote is required; you can just purge the changes from your workspace,<br />

restoring the version that was in the backing stream at the time of the workspace’s most recent<br />

update. Prior to <strong>AccuRev</strong> 4.6, “underlap” files were considered to have “overlap” status.<br />

In a new workspace, the status of every element is backed. This means that the version in your<br />

workspace is identical to the version in the backing stream. The following sections describe the<br />

other statuses.<br />

<strong>AccuRev</strong>® <strong>CLI</strong> User’s <strong>Guide</strong> 11

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!