AccuRev® Command-Line Reference : cpkadd

cpkadd
add an entry to a change package
Usage
accurev cpkadd [ -p <depot-name> ] [-I <issue-number> [-3] ][ -fx ]
{ [ -v <ver-spec> ] <element-list> | -v <ver-spec> -e <eid> |
-k | [ -Fx ] -l <list-file> }
Description
The cpkadd command creates or updates an entry for one or more elements in the specified change package. You can specify an element by its name or its element-ID.
Options
-I <issue-number>
The issue record whose change package will be processed.
-3
Specifies that the <issue-number> specified by the -I switch is a third-party ITS key rather than an AccuWork issue number.
-k
Process all (kept) elements in the workspace.
 
-e <eid>
The element whose change is to be recorded. You must also specify a version with -v. If you also specify a <list-file> or <element-list>, it is ignored.
-Fx
Signals that <list-file> (see the -l option) is an XML-format file, not a flat text file. Example:
<elements>
  <e l="\.\file_0001" v="4/1" eid="2"></e>
  <e l="\.\file_0002" v="4/1"></e>
  <e eid="4" v="4/1"></e>
</elements>
–l <list-file>
Process the elements listed in <list-file>. This must be a text file, with one element name per line. Extra whitespace is not allowed; make sure there are no empty lines and no leading or trailing white space around the filenames. Wildcards are not expanded. There is no provision for comment lines in the file.
If you use this option, any <element-list> specified is silently ignored.
<element-list>
One or more element names, separated by whitespace. If you also specify a <list-file> using the –l option, this <element-list> is silently ignored.
-v <ver-spec>
(default: the version currently in your workspace) The head version of the change. Typically, this also becomes the head version in the change package entry. But if this command modifies an existing change package entry by “filling in the past”, another entry may become the head version.
AccuRev automatically determines the basis version of the change. See the patch reference page for a description of the basis version.
-p <depot-name>
The depot in which the issue record is located (default: the depot of the current workspace).
-fx
Display the results in XML format. If the command succeeds, the response is:
<acResponse/>
If the command fails, the response is:
<acResponse>
<Message>Issue not found.</Message>
</acResponse>
Examples
Create or update a change package entry for element brass.h in issue record #982. The head version of the change is the version of brass.h currently in the workspace.
> accurev cpkadd -I 982 brass.h
Create or update a change package entry in issue record #4871, for the element with element-ID 477. The head version of the change is the version in workspace brass_dvt_john.
> accurev cpkadd -I 4871 -e 477 -v brass_dvt_john
See Also
cpkdescribe, cpkdepend, cpkremove, issuediff, issuelist, patch
Using a Specific Version of an Element on page 18

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com