diffbl
Compares the contents of baselines or streams
Applicability
Product |
Command type |
|---|---|
VersionVault |
cleartool subcommand |
Platform |
|---|
UNIX |
|
Linux |
Windows |
Synopsis
- Display differences between two
baselines or streams nongraphically:
- diffbl [ –act/ivities ] [ –ver/sions | -elements ] [ –bas/elines ]
- [ –fir/st_only ] [ –nre/curse ]
[ –nme/rge ]
{ baseline-selector1 | stream-selector1 }
{ baseline-selector2 | stream-selector2 }
- Display differences between the
specified baseline and its predecessor baseline nongraphically:
- diffbl –pre/decessor [ –act/ivities ] [ –ver/sions ] [ –nre/curse ] [ –nmerge ] baseline-selector
- Display differences between two
baselines graphically:
- diffbl –g/raphical baseline-selector1 baseline-selector2
- Display differences between the
specified baseline and its predecessor baseline graphically:
- diffbl –g/raphical –pre/decessor baseline-selector
Description
The diffbl command compares the contents of two baselines or streams and displays any differences it finds. You can choose to see differences in terms of activities, versions, and for composite baselines, members.
You can use the diffbl command to compare a baseline and a stream, a baseline and a baseline, or a stream and a stream. When specifying a stream, all baselines in the stream are used in the comparison as well as any changes in the stream that are not yet captured in a baseline. The following symbols are used to describe the results of a comparison:
| Symbol | Meaning |
|---|---|
| << | The item is present only in baseline-selector1 or stream-selector1. |
| >> | The item is present only in baseline-selector2 or stream-selector2. |
| <- | The activity is present in both of the items being compared and is newer in baseline-selector1 or stream-selector1. |
| -> | The activity is present in both of the items being compared and is newer in baseline-selector2 or stream-selector2. |
| none | There are no differences between the objects being compared. |
To display version information, the diffbl command must be issued from a view context.
Restrictions
None.
Options and arguments
Specifying the information to display
- Default
- –activities
- –act/ivities
- Displays differences in terms of activities.
- –ver/sions
- Displays differences in terms of versions.
- –elements
- Displays differences in terms of elements.
- –bas/elines
- For composite baselines, displays differences in terms of member baselines. When used with the –activities option, displays each member baseline followed by activities in the member baseline.
- –fir/st_only
- Shows only those changes that appear in the first object specified for the comparison.
- –nre/curse
- For composite baselines, displays differences between the named baselines themselves and not between their members.
- –nme/rge
- Compares two baselines on the same stream and reports only activity and version changes made on that stream.
Comparing a version with its predecessor
- Default
- None.
- –pre/decessor
- Displays differences between the specified baseline and its immediate predecessor.
Reporting differences graphically
- Default
- Reports differences in nongraphical form.
- –g/raphical
- Displays differences graphically. This applies only to baselines, not streams.
Selecting the objects to compare
- Default
- None.
- baseline-selector1 , stream-selector1
- Specifies objects to use in the comparison.
baseline-selector is of the form: [baseline:]baseline-name[@vob-selector] and vob is the baseline's UCM project VOB. stream-selector is of the form: [stream:]stream-name[@vob-selector] and vob is the stream's UCM project VOB.
- baseline-selector2, stream-selector2
- Specifies objects to use in the comparison.
baseline-selector is of the form: [baseline:]baseline-name[@vob-selector] and vob is the baseline's UCM project VOB. stream-selector is of the form: [stream:]stream-name[@vob-selector] and vob is the stream's UCM project VOB.
Examples
The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you might need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you might need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.
- Compare activities in two streams:
cmd-context diffbl stream:java_int stream:java_dev Comparing the following: java_int java_dev Differences: << deliver.java_dev.19990917.140443 "deliver java_dev on 09/17/99 14:04:43." << deliver.java_dev.19990917.141046 "deliver java_dev on 09/17/99 14:10:46." - Compare baselines in two streams:
cmd-context diffbl -ver stream:java_int stream:java_dev
Comparing the following:
java_int
java_dev
Differences:
<< /vobs/parser/myfile.c@@/main/java_int/2
<< /vobs/parser/myfile.c@@/main/java_int/3 - Compare a baseline with its predecessor baseline:
cmd-context diffbl -predecessor
test_sum.D001207.124@net/acrolein/export/home/lli/vobs/lli_test_sum
Comparing the following:
test_sum.D001207.124@net/acrolein/export/home/lli/vobs/lli_test_sum
test_sum.D001207.123@net/acrolein/export/home/lli/vobs/lli_test_sum
Differences:
>> deliver.lli_test_sum.20001113.165650 “deliver lli_test6_sum on
11/13/00 16:56:50."
>> test_act_00795 “test act"