accurev cpkdepend -s <from-stream> [ -S <to-stream> ] [ -fv ]
[ -I <”issue_number1 issue_number2...”> ] [-3] ] [ -p <depot-name> ] [ -fx ]
[ -I <”issue_number1 issue_number2...”> ] [-3] ] [ -p <depot-name> ] [ -fx ]
The cpkdepend command lists the issue records on which the specified issue record(s) depend. It can also produce a dependency listing for an entire depot.
|
•
|
For the purposes of this command, “issue record N” is shorthand for “change package of issue record N”.
|
At this point, issue record #13 is active in stream brass_dvt. Promoting that issue record (using promote -Fx -l) promotes version brass_dvt/6 (real version: brass_dvt_phil/25).
Issue A depends on issue B, in the context of a promotion from stream S1 to stream S2, if issue A is active in stream S1 and at least one element meets all the following conditions:
|
•
|
|
•
|
The head version of the element’s entry in issue A is a descendant of the head version in issue B. (That is, the A version contains the changes made in the B version.)
|
|
•
|
Stream S2’s version of the element is not either the head version of the element’s entry in issue B or a descendant of it. (That is, the changes made in the B version have not yet been promoted to stream S2.)
|
For each issue record, there is a dependency hierarchy: the issue directly depends on several issues; each of those issues directly depends on several issues; and so on. cpkdepend does not display dependencies hierarchically, though. (The AccuRev GUI does.) Instead, it displays one or more lists:
|
•
|
If you omit the -fv option, cpkdepend displays a single list: the set of issue records that are direct or indirect dependencies of the issue(s) specified with -I:
|
> accurev cpkdepend -I 9 -s brass_dvt
Issue Depends On
9 7, 1, 3, 2
> accurev cpkdepend -I 5,9 -s brass_dvt
Issue Depends On
5, 9 1, 3, 2, 4, 7
Issue Depends On
9 7, 1, 3, 2
> accurev cpkdepend -I 5,9 -s brass_dvt
Issue Depends On
5, 9 1, 3, 2, 4, 7
|
•
|
If you include the -fv option, cpkdepend displays a list of the direct dependencies for each issue record in the dependency hierarchy of the issue(s) specified with -I:
|
|
•
|
If you include the -fv option but omit the -I option, cpkdepend lists all the issue records in the depot that have dependencies. For each such issue record, its set of direct and indirect dependencies is included:
|
> accurev cpkdepend -s brass_dvt -fv
Issue Depends On
1 3, 2
2 1, 3
3 1, 2
4 1, 3, 2
7 1, 3, 2
8 2, 1, 3
9 7, 1, 3, 2
12 11, 10, 4, 1, 3, 2
Issue Depends On
1 3, 2
2 1, 3
3 1, 2
4 1, 3, 2
7 1, 3, 2
8 2, 1, 3
9 7, 1, 3, 2
12 11, 10, 4, 1, 3, 2
Note: cpkdepend can report that A depends on B and B depends on A. This indicates that both issue records have change package entries with the same head version for one or more elements.
The change package dependency hierarchy of an issue record can be quite substantial. Even if just one or two elements cause an issue record (A) to depend on just a few other issue records (B,C,D,...), it might be that other elements in the dependent issue records (B,C,D,...) produce a large number of further dependencies.
Suppose that executing cpkdepend reveals that dependencies exist in a particular promotion situation — say, issue record #8 depends on issue records #1, #2, and #3. You can handle this situation by propagating less data to the destination stream, or by propagating more data:
|
•
|
“Go for less” alternative: instead of promoting issue record #8, use the patch command on one or more elements in its change package, in order to include the changes made for issue record #9, but excluded the changes made for issue records #1, #2, and #3.
|
-s <from-stream>
-S <to-stream>
Specifies that the <issue-number(s)> specified by the -I switch are third-party ITS keys rather than AccuWork issue numbers.
(“verbose”) For each issue record in the dependency hierarchy(s) of the issue record(s) specified with -I, display a list of its direct dependencies. Default: display a single list, showing the direct and indirect dependencies of the issue record(s) specified with -I.
If you omit -I, display a list of the direct and indirect dependencies of the each issue record that has dependencies in the specified stream context.
Display the direct and indirect dependencies of issue records #1004 and #1443, in the context of promotion from stream widget_dvt to its parent stream.