AccuRev User's Guide (GUI)

Making Your Changes Public
To make your work available to others, you promote
your kept files. You can invoke the Promote
command from the context menu of a selected file
(or group of files). There is also a Promote
toolbar button:
If the files you wish to keep reside in several
different directories, you can select all of them at
once from the results of a Kept or Pending search.
(See Working in the Searches Pane on page 73.)
Promoting a file makes the private version, which
you previously created in your workspace with
Keep, into a public version. The public version
resides in your workspace’s backing stream. Anyone
else whose workspace has the same backing stream
can incorporate your promoted versions, using the
Update command.
Concurrent Development — When Streams Collide
If someone else promotes a change to a file before you do, the changes are said to overlap. Before
promoting your changes to the backing stream, you must merge the already-promoted changes
into your work. Merging is a big topic; for more on AccuRev’s Merge tool, see The AccuRev Diff,
Merge, and Patch Tools on page 117.
Getting in Touch With Your Past
AccuRev keeps track of the complete history of each version-controlled file (or element). This
history consists of the set of transactions that involved that particular element. Typically, most of
an element’s transactions are Keep and Promote actions. Transactions are also logged in other
situations: when an element is first added to the depot (create, even though the command-name is
Add to Depot), when you rename it or move it to a different directory (move), when you
incorporate someone else’s changes into your work (merge), etc. In general, any change to a
depot gets logged by a transaction.
AccuRev User’s Guide (GUI) 36