xclearcase

Primary ClearCase and ClearCase LT graphical interface utility

APPLICABILITY

SYNOPSIS

• Start in File Browser:

xclearcase [ X-options ] [ -file ] [ -ngraph ] pname ...

• Start in Version Tree Browser:

xclearcase [ X-options ] -vtree [ -all ] [ -nme·rge ] [ -nco ]

[ -lab·el ] [ -ngraph ] [ -tag view-tag[,...] ] pname ...

• Start in Hyperlink Tree Browser:

xclearcase [ X-options ] -htr·ee [ -dir·ect | { -nel·ement | -nbr·anch | -nve·rsion } ] ...

[ -inc·lude hlink-type[,...] | -exc·lude hlink-type[,...] ] [ -to_only | -fro·m_only ]
[ -tex·t ] [ -ngraph ] pname ...

• Start inType Browser:

xclearcase [ X-options ] { -att·ype | -brt·ype | -elt·ype | -hlt·ype | -lbt·ype | -trt·ype }

DESCRIPTION

The xclearcase command invokes the ClearCase or ClearCase LT GUI (graphical user interface).

xclearcase is implemented as an X Window System application using a standard window system toolkit. See your X Window System documentation for a description of mouse and keyboard conventions.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

SELECTING A BROWSER.  Default: Starting xclearcase brings up the main panel, an enhanced file browser. (xclearcase -file has the same effect.)

-file [ -ngraph ] dir-pname ...

Starts a separate file browser on each of the specified VOB directories (or a single browser on the current working directory). Using -ngraph starts non-graphical browsers; objects are listed by name instead of being displayed as icons.

-att·ype , -brt·ype , -elt·ype , -hlt·ype , -lbt·ype , -trt·ype

Starts a single type browser.

-vtr·ee [ -all ] [ -nme·rge ] [ -nco ] [ -tag view-tag[,...] ] pname ...

Similar to the cleartool lsvtree -graphical command. See the lsvtree reference page for details on the -all, -nmerge, and -nco options. Read the section X RESOURCES for information on the -tag option.

-htr·ee [ options ]

Starts a Hyperlink Tree Browser. By default, the browser starts in inheritance mode; use -direct to start it in direct mode.

By default, there is no filtering of hyperlinks by kind of file-system object; use -nelement, -nbranch, and/or -nversion to exclude links whose left ends are connected to certain kinds of objects.

By default, there is no filtering of hyperlinks by direction; use -from_only or -to_only to restrict the display to hyperlinks from/to the specified pname.

By default, hyperlinks of all types except Merge are displayed; use -include or -exclude to specify exactly which types to display.

By default, annotations to hyperlinks are indicated by a single quote ( ' ); use -text to display full annotations.

By default, the browser uses a graphical display (icons); use -ngraph to have the browser start in text mode.

X WINDOW SYSTEM OPTIONS.  Default: None.

X-options

xclearcase accepts all the standard X Toolkit command-line options (for example, -display), as described in the X(1) reference page. Quote the option string if it includes white space.

X RESOURCES

Following are the shell instance names for the xclearcase browsers and transcript pad:

xclearcase.vtree
xclearcase.metatype
xclearcase.file
xclearcase.viewtag
xclearcase.vob
xclearcase.username
xclearcase.string
xclearcase.list
xclearcase.pool
xclearcase*transcript

The vtreeTagColors resource takes a comma-separated list of colors. For example:

xclearcase.vtreeTagColors: DarkOliveGreen4,Blue,IndianRed2

The colors on this list are used for the view-tag annotations specified by the -tag option.

You can use the useSmallFonts resource to increase the density of the File Browser's display, both when displaying file names and when displaying icons:

xclearcase.useSmallFonts: True

EXAMPLES

• Start the graphical user interface.

% xclearcase

• Start the graphical user interface in view test_vu.

% cleartool setview -exec xclearcase test_vu

• Display the version tree for element base.c, annotating the version selected by view dvt_vu in blue, and the version selected by view fix_vu in red.

% xclearcase -xrm "xclearcase.vtreeTagColors: blue,red" -vtree -tag dvt_vu,fix_vu base.c

SEE ALSO

X(1)