diffbl

Compares the contents of UCM baselines or streams

APPLICABILITY

SYNOPSIS

• Display differences between two baselines or streams nongraphically:

diffbl [ -act·ivities ] [ -ver·sions ] [ -fir·st_only ]

{ 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 ] 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 or versions, or both.

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 diffbl command must be issued from a view context to display versions. The view context is needed to resolve pathnames of versions.

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.

-fir·st_only

Shows only those changes that appear in the first object specified for the comparison.

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 only applies to baselines and not streams.

SELECTING THE OBJECTS TO COMPARE. Default: None.

baseline-selector1

stream-selector1

Specifies an object 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 an object 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 examples in this section are written for use in csh. If you use another shell, you may 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 may 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 shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

NOTE: In the UNIX examples that follow, arguments and output that show multicomponent VOB tags are not applicable to ClearCase LT, which recognizes only single-component VOB tags. In this manual, a multicomponent VOB tag is by convention a two-component VOB tag of the form /vobs/vob-tag-leaf-for example, /vobs/src. A single-component VOB tag consists of a leaf only-for example, /src. In all other respects, the examples are valid for ClearCase LT.

Compare activities in two streams:

cmd-context diffbl stream:java_int stream:java_dev

<< 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

<< /vobs/parser/myfile.c@@/main/java_int/2

<< /vobs/parser/myfile.c@@/main/java_int/3

• Compare a baselines with its predecessor baseline:

cmd-context diffbl -predecessor test_sum.D001207.124@net/acrolein/export/home/lli/vobs/lli_test_sum

>> deliver.lli_test_sum.20001113.165650 "deliver lli_test6_sum on 11/13/00 16:56:50."

>> test_act_00795 "test act"

SEE ALSO

chbl, lsbl, mkbl, rmbl