xclearcase

Primary VersionVault graphical interface utility

Applicability


Product	Command type
VersionVault	command


Platform
UNIX®
Linux®

Synopsis

Start in File Browser:

xclearcase [ X-options ] [ –file ] [ –ngraph ] pname ...
Start in Version Tree Browser:

xclearcase [ X-options ] –vtree [ –all ] [ –nmerge ] [ –nco ]

[ –label ] [ –ngraph ] [ –tag view-tag[,...] ] pname ...
Start in Hyperlink Tree Browser:

xclearcase [ X-options ]

–htree [ –direct | { –nelement | –nbranch | –nversion } ] ...
[ –include hlink-type[,...] | –exclude hlink-type[,...] ]

[ –to_only | –from_only ] [ –text ] [ –ngraph ] pname ...
Start in Type Browser:

xclearcase [ X-options ]

{ –attype | –brtype | –eltype | –hltype | –lbtype | –trtype }

Description

The xclearcase command invokes the VersionVault GUI (graphical user interface).

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

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 nongraphical browsers; objects are listed by name instead of being displayed as icons.

–attype , –brtype , –eltype , –hltype , –lbtype , –trtype

Starts a single type browser.

–vtree[ –all ] [ –nmerge ] [ –nco ] [ –tag view-tag[,...] ] pname ...

Similar to the cleartool lsvtree –graphical command. For details about the –all, –nmerge, and –nco options, see the lsvtree reference page. For information about the –tag option, see the section X resources.

–htree [ 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, 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.

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

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