The Add to Depot Command

Invoking the Add to Depot Command

Using the Add to Depot Dialog

Basic Options

Advanced Options

Results of an Add to Depot Operation -- the Details

The Add to Depot command places the selected files and/or directories under version control The discipline of keeping track of the changes made over time to a file or directory.. For each file/directory, this includes:

The status of each file/directory changes from (external) to (kept).

Invoking the Add to Depot Command

In the Details pane of a File Browser that is open on a workspace, select one or more files and/or directories. All the selected objects must currently have (external) status. Then:

The Add to Depot dialog appears, which you use to complete the command.

Using the Add to Depot Dialog

The Add to Depot dialog includes basic options (always visible) and advanced options (visibility controlled by a Basic/Advanced button).

Basic 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 sessionAdd to Depot comment.) The comment string becomes a permanent annotation to the version you're creating.

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 Add to Depot command.

Advanced Options

Choose File Type

By default, AccuRev determines the element type for the newly created version automatically (text or binary). You can override the default by specifying either of these types or ptext (a variant of text). See AccuRev Element Types.

Choose Lock Type

Choosing Enable File Locking places a lock A control on the file element, requiring (1) users must Anchor the file before editing it, and (2) if a user has Anchor'ed the file, users in sibling workspaces cannot Anchor or edit the file. on the element, to enforce serial development The practice of ensuring that multiple users do not work concurrently on the same version-controlled file. See parallel development. in sibling workspaces Two or more workspaces or streams that have the same parent stream. for that element. This ensures that users in sibling workspaces won't have to merge An operation that combines the contents of two versions (contributors) of the same element. To merge the contents of text files, AccuRev uses a '3-way merge' algorithm: it compares the two files line-by-line with a third file, the version that is the closest common ancestor of the other two. Merging of namespace changes also takes into account the closest common ancestor. their work on this element. The lock remains on the element until you (or someone else) changes this value to Disable File Locking in a subsequent Keep command. See File Locks.

Add links as symbolic links

By default, a symbolic link (UNIX/Linux) or junction point (Windows) is added to the depot as an AccuRev element link, not as an AccuRev symbolic link. Use this checkbox to cause such objects to be converted to AccuRev symbolic links.

Results of an Add to Depot Operation -- the Details

The Add to Depot command does the following:

Notes (click to view):