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
See Also
X(1)