diffbl

Compares the contents of baselines or streams

APPLICABILITY

SYNOPSIS

• Display differences between two baselines or streams nongraphically:

diffbl [ -act·ivities ] [ -ver·sions ] [ -bas·elines ] [ -fir·st_only ] [ -nre·curse ]

{ 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, 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 diffbl command must be issued from a view context to display 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.

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

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