AccuRev CLI User's Guide

add add a new element to a depot
Usage
accurev add [ -c ] [ -E ] [ -x ] [ -R ] [ -s ]
[ -fi ] { -l | }
Description
The add command converts one or more existing files, directories, and/or links in a workspace to
version-controlled elements. The new elements are placed in the depot associated with your
workspace. (They cannot be moved later to another depot.) Version 1 of each element is created
in your workspace stream. The new elements will not appear in other streams or workspaces until
you promote them.
In the transaction recorded in the depot’s database for an add command, the AccuRev operation is
listed as “create”, not “add”. Transactions are listed by the hist command.
If a pre-create-trig trigger is defined for the depot, it fires before the add command is executed.
See the mktrig reference page and AccuRev Triggers on page 53 of the AccuRev Administrator’s
Guide.
Controlling the Element Type and Exclusive File Locking State
By default, add guesses an element type for each file element it creates:
• If the file is strict ASCII, it sets the element type to text.
• Otherwise, it sets the element type to binary.
Note: Unicode files are considered to be binary, not text.
You can override add's element type determination with the –E option, specifying text, binary,
or a third element type, ptext (a variant of text, never assigned automatically). See below for a
description of how AccuRev handles ptext elements. You can also set the new element’s
exclusive file locking state: serial (exclusive file locking enabled) or parallel (exclusive file
locking disabled).
By default, all files in a workspace are writable. You can edit any file at any time, and use keep to
create new versions of them. But if you use the –E serial option, the file becomes read-only after
you promote it to the backing stream. See Exclusive File Locking and Anchor-Required
Workspaces on page 4.
You can change both the element type and exclusive file locking state in subsequent keep –E
commands. This change affects the newly created version and future versions only; it does not
change the type of any existing version.
To see an element’s type, use the hist –fv or stat –fk command. To see an element’s exclusive file
locking state, use the stat –fx command (“hierType” attribute in the XML-format listing).
AccuRev CLI User’s Guide 40