xclearcase
Primary ClearCase® graphical
interface utility
Applicability
Product
|
Command
type
|
|---|
ClearCase
|
command
|
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 ClearCase 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.
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:
The vtreeTagColors resource takes
a comma-separated list of colors. For example:
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:
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