schemes

X Window System resources for ClearCase and ClearCase LT Graphical User Interfaces (GUIs)

APPLICABILITY

ProductCommand type
ClearCasedata structure
ClearCase LTdata structure

Platform
UNIX

SYNOPSIS

ClearCase and ClearCase LT GUIs use Common Desktop Environment (CDE) settings or can read scheme files.

DESCRIPTION

Scheme files are collections of X Window System resource settings that control the geometry, colors, and fonts used by application GUIs. By default, ClearCase and ClearCase LT do not enable schemes. Instead, the GUIs use the settings that your Common Desktop Environment (CDE) specifies. However, you can enable schemes and use the ClearCase and ClearCase LT schemes mechanism by adding the following resource to your .Xdefaults file:

*useSchemes: all

All ClearCase and ClearCase LT GUIs except the following support the schemes mechanism:

  • cleardescribe
  • clearhistory

Each scheme is implemented as a separate directory. For example, the scheme Turner consists of four files:

Turner/palette Defines mnemonic names for colors and fonts, using a subset of standard cpp(1) syntax:

#ifndef GAMMA_1_0
#define TextForeground         #fffff
#define BasicBackground        #002e5c
#define ScrolledListBackground  #623463
.
.

Turner/Turner Specifies resources for use by the X Toolkit widgets that make up the GUI panels. These resources can be specified absolutely, or in terms of the mnemonic names defined in the palette file:

*XmText*marginHeight: 4
.
.
.
*foreground: TextForeground
*background: BasicBackground

Turner/ClearCasepalette Extends and/or overrides the standard palette definitions.
Turner/ClearCaseExtends and/or overrides the standard Turner file definitions,

The two mnemonic map declaration files are combined, as are the two resource definition files. If the same resource is specified in the standard file and the ClearCase or ClearCase LT file, the specification in the ClearCase or ClearCase LT file is used. To add your own definitions or to replace existing ones, either edit one or both of the files specific to ClearCase and ClearCase LT or create your own scheme files and specify a scheme file search path, as described in the section “Search Path for Schemes”.

Note that the palette and ClearCasePalette files are not actually processed by cpp; they are processed by the ClearCase or ClearCase LT GUI itself. The resources (Turner and ClearCase) apply only to the program that reads them. They are not added to the RESOURCE_MANAGER property of the root window and, therefore, do not affect other X applications.

Schemes are configured at two levels:

  • Your display's X resources enable scheme use and specify the name of a particular scheme.
  • A search path capability supports maintenance of systemwide and personal schemes.

Resources for Schemes

The scheme resource specifies a scheme to be used by the ClearCase or ClearCase LT GUI. For example:

*scheme: TurnerSpecifies scheme for all GUI utilities
xclearcase*scheme: TurnerSpecifies scheme for xclearcase

If you enable scheme use but do not specify a particular scheme, the color scheme Lascaux or the black-and-white scheme Willis is used. If you do not explicitly enable schemes, the CDE resource settings are used.

Monochrome and Grayscale Schemes

By default, users working on a monochrome monitor get the Willis scheme, and users working on a grayscale monitor gets the Print scheme. You can override these assignments with the resources *monoScheme and *grayScheme, respectively. If you specify an alternative scheme, it must be located in the scheme search path, which is described in the following section.

Search Path for Schemes

The GUIs use a search path to find scheme directories. The default search path is /usr/lib/X11/Schemes:/opt/rational/config/ui/Schemes.

You can use the environment variable SCHEMESEARCHPATH to specify a colon-separated list of directories to be searched instead. Each entry on this list must be in the following standard X Toolkit form:

pathname/%T/%N%S

The GUIs always make these substitutions:

%T ➔⇒ Schemes
%N➔ ⇒ scheme-name
%S ⇒ ➔(null)

For example, if your SCHEMESEARCHPATH value is

/netwide/config/ui/%T/%N%S:/home/gomez/%T/%N%S 

and your .Xdefaults file includes the line

*scheme: Rembrandt 

then the GUI reads resource schemes from these two directories:

/netwide/config/ui/Schemes/Rembrandt
/home/gomez/Schemes/Rembrandt

The GUI searches for the first instance of each scheme file (the standard map declaration file, the standard resource definition file, and the versions of the standard files), and then concatenates the files.

Note: If the GUI does not find a complete set of scheme files, it returns an error. Therefore, we recommend that you include the default search path in the SCHEMESEARCHPATH environment variable.

International Language Support

If your site uses the language resource *xnlLanguage to implement pathname substitutions based on national language and/or codeset, you may want to expand customized SCHEMESEARCHPATH entries to use one or more of these optional substitution parameters:

%L ⇒ ➔value of *xnlLanguage (language[_territory][.codeset])
%l➔ ⇒ language
%t ⇒ ➔ territory (if any)
%c ➔⇒ codeset (if any)

For more information about constructing directory trees to store language-dependent application text files, see X Windows System Toolkit documentation.

Platform-Specific Support

On some platforms, there are specific requirements for the location of the Schemes directory. For information about platform-specific requirements, see the Release Notes.

FILES

ccase-home-dir/config/ui/Schemes/Gainsborough/*
ccase-home-dir/config/ui/Schemes/Lascaux/*
ccase-home-dir/config/ui/Schemes/Leonardo/*
ccase-home-dir/config/ui/Schemes/Monet/*
ccase-home-dir/config/ui/Schemes/Print/*
ccase-home-dir/config/ui/Schemes/Rembrandt/*
ccase-home-dir/config/ui/Schemes/Sargent/*
ccase-home-dir/config/ui/Schemes/Titian/*
ccase-home-dir/config/ui/Schemes/Turner/*
ccase-home-dir/config/ui/Schemes/VanGogh/*
ccase-home-dir/config/ui/Schemes/Whistler/*
ccase-home-dir/config/ui/Schemes/Willis/*

SEE ALSO

cleardescribe, clearhistory, cpp(1), X Toolkit documentation, Common Desktop Environment documentation



Copyright© 2003 Rational Software. All Rights Reserved.