
<!-- "@(#)resources	1.5 97/06/02 Sun Microsystems, Inc." >

<title>Customizable X Resources</title>
<h1>Customizable X Resources</h1>

Like most X Windows applications,
    <a href="cconsole/home_page">Cluster Console</a>
contains a number of customizable X resources.  On top of the default
resource mechanisms for an X application, the Cluster Console
attempts to automatically load in the system-wide application defaults
file (usually <tt>/opt/SUNWcluster/app-defaults/cconsole</tt>) by
making sure the path to it is in the <tt>XFILESEARCHPATH</tt>
environment variable.  <p>

You can always override these resources, for example, by setting them
in your <tt>~/.Xdefaults</tt> file or any file in the path specified by
the <tt>XUSERFILESEARCHPATH</tt> environment variable.  <p>

Below are some of the most commonly set resources (and their default
values).  Note that the defaults listed here are those you would see
if you were using the standard application defaults files shipped
with this product.  <p>


<hr>
<b>Application Specific</b><p>

(These are custom resources defined specifically for Cluster Console). <p>

<dl>
<dt> <tt>cconsole*groupTermWindowsDefault: On</tt>
<dd> Specifies the default (initial) value for the <b>Group Term Windows</b>
     togglebutton under the <b>Options</b> menu.  Possible values are:
     <ul>
     <li> <tt>On</tt> - Togglebutton is on at startup time.
     <li> <tt>Off</tt> - Togglebutton is off at startup time.
     </ul>
</dl>



<hr>
<b>Application Operation</b>

<dl>
<dt> <tt>cconsole*keyboardFocusPolicy: pointer</tt>
<dd> Specifies the style of keyboard focus for the application.  Possible
     values are:
     <ul>
     <li> <tt>explicit</tt> - Specifies click-to-type focus.
     <li> <tt>pointer</tt> - Specifies pointer-driven focus.
     </ul>
</dl>



<hr>
<b>Application Appearance</b>

<dl>
<dt> <tt>cconsole*background: gray</tt>
<dd> Specifies the background color for the application.
     <p>
<dt> <tt>cconsole*fontList: -adobe-helvetica-bold-r-normal--12-*-75-75-*-*-*-*</tt>
<dd> Specifies the font of the text used in the application.
     <p>
<dt> <tt>cconsole*foreground: (dynamic)</tt>
<dd> Specifies the foreground color for the application.
     <p>
</dl>



<hr>
<b>Term Window Operation</b>

<dl>
<dt> <tt>cconsole*termw*autoWrap: True</tt>
<dd> Specifies whether or not the Term Window text cursor wraps around to
     the next row once it has gone past the rightmost column on a row.
     <p>
<dt> <tt>cconsole*termw*jumpScroll: True</tt>
<dd> Specifies whether or not jump scrolling should be used.  Under jump
     scrolling, the screen may be scrolled more than one line at a time.
     This provides for faster screen updates when multiple lines of text
     are being sent to the terminal.  The maximum number of lines that may
     be jump scrolled is limited to the number of lines in the terminal
     window.  It is guaranteed that all lines will be displayed.
     <p>
<dt> <tt>cconsole*termw*reverseWrap: True</tt>
<dd> Specifies whether or not the Term Window text cursor wraps around to
     the previous row once it has gone backwards past the leftmost column on 
     a row (except the first row).
     <p>
<dt> <tt>cconsole*termw*saveLines: 40s</tt>
<dd> Specifies the number of lines/screens beyond the length of the Term Window that
     are saved by the terminal buffer.  The value consists of a number followed
     by an optional suffix where values for the suffix are:
     <ul>
     <li> <tt>l (ell)</tt> - number before suffix specifies number of <b>lines</b>
	  to save.
     <li> <tt>s</tt> - number before suffix specifies # of <b>screens</b> to save
	  (beyond the current one).
     </ul>
     For example, the default value above means that 40 screens beyond the
     visible one (for a total of 41) will be saved.
     <p>
</dl>



<hr>
<b>Term Window Appearance</b>

<dl>
<dt> <tt>cconsole*termw*blinkRate: 0</tt>
<dd> Specifies the blink rate for the Term Window's text cursor.  Specifically,
     the value is the number of milliseconds the cursor is in the "on" and
     "off" states while blinking.  A value of <tt>0</tt> will turn blinking off.
     <p>
<dt> <tt>cconsole*termw*columns: 80</tt>
<dd> Specifies the initial number of columns of text in each Term Window.
     <p>
<dt> <tt>cconsole*termw*charCursorStyle: CHAR_CURSOR_BOX</tt>
<dd> Specifies the shape of the Term Window's text cursor.  Possible values
     are <tt>CHAR_CURSOR_BOX</tt> (box cursor) and <tt>CHAR_CURSOR_BAR</tt>
     (underbar cursor).
     <p>
<dt> <tt>cconsole*termw*marginHeight: 2</tt>
<dd> Specifies the height of the margin between the text and the top and
     bottom of the Term Window.
     <p>
<dt> <tt>cconsole*termw*marginWidth: 2</tt>
<dd> Specifies the width of the margin between the text and the left and
     right sides of the Term Window.
     <p>
<dt> <tt>cconsole*termw*rows: 24</tt>
<dd> Specifies the initial number of rows of text in each Term Window.
     <p>
<dt> <tt>cconsole*termw*shadowThickness: 2</tt>
<dd> Specifies the width of the shadow drawn around the text area in the
     Term Window.
     <p>
<dt> <tt>cconsole*termw*shadowType: SHADOW_IN</tt>
<dd> Specifies the type of the shadow drawn around the text area in the
     Term Window.  Possible values are <tt>SHADOW_IN</tt>, <tt>SHADOW_OUT</tt>,
     <tt>SHADOW_ETCHED_IN</tt>, <tt>SHADOW_ETCHED_OUT</tt>.
     <p>
<dt> <tt>cconsole*termw*pointerBlank: False</tt>
<dd> Specifies whether or not the Term Window pointer cursor is in blanking mode.
     In this mode, the cursor turns on when the pointer is moved, and is blanked
     either after a selectable number of seconds or after keyboard input.  The
     delay is set via the <tt>pointerBlankDelay</tt> resource (below).
     <p>
<dt> <tt>cconsole*termw*pointerBlankDelay: 2</tt>
<dd> If the Term Window pointer cursor is in blanking mode, specifies the number 
     of seconds to wait after the pointer has stopped moving before blanking 
     the pointer (see the <tt>pointerBlank</tt> resource, above).  A value of 
     <tt>0</tt> prevents the pointer from blanking until a key is pressed.
     <p>
<dt> <tt>cconsole*termw*pointerColor: (dynamic)</tt>
<dd> Specifies the foreground color for the Term Window's pointer cursor.
     <p>
<dt> <tt>cconsole*termw*pointerColorBackground: (dynamic)</tt>
<dd> Specifies the background color for the Term Window's pointer cursor.
     <p>
<dt> <tt>cconsole*termw*pointerShape: xterm</tt>
<dd> Specifies the X cursor font character the Term Window uses for its
     pointer cursor.  The font character should be specified as a string
     from the include file <tt>$OPENWINHOME/include/X11/cursorfont.h</tt>, 
     with the leading <tt>XC_</tt> removed.
     <p>
<dt> <tt>cconsole*termw*userFont: (dynamic)</tt>
<dd> Specifies the font the Term Window uses for its terminal text.
     <p>
<dt> <tt>cconsole*termw*userBoldFont: (dynamic)</tt>
<dd> Specifies the font the Term Window uses for its bold terminal text.
     <p>
</dl>

<hr>
<b>Menu Resources</b><p>
These are resources for the each of the menu options available in cconsole.<p>
<ul>
<li><tt>labelString:</tt> The string displayed on the menu button.
<p>
</li>
<li><tt>mnemonic:</tt> The letter/character which activates the menu item when
the  menu  is displayed/posted.This   letter/character has  to be  one  of the
characters in the labelString and it will be underlined.
<p>
</li>
<li><tt>accelerator:</tt>The keystroke combination  that invokes the menu item
even when the menu is not displayed/posted. Normally these are a combination of
CTRL or ALT key with some other key.
<p>
</li>
<li><tt>acceleratorText:</tt>The text displayed for the accelerator.This is to
provide a visual feedback to the user regarding the accelerator.
<p>
</li>
</ul>

<hr>
<b>Help Window Appearance</b>

<dl>
<dt> <tt>cconsole*help_window*html*font: -adobe-helvetica-medium-r-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the normal font used for Help Window text.
     <p>
<dt> <tt>cconsole*help_window*html*italicFont: -adobe-helvetica-medium-o-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the italic font used for Help Window text.
     <p>
<dt> <tt>cconsole*help_window*html*boldFont: -adobe-helvetica-bold-r-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the bold font used for Help Window text.
     <p>
<dt> <tt>cconsole*help_window*html*fixedFont: -adobe-courier-medium-r-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the fixed-pitch font used for Help Window text.
     <p>
<dt> <tt>cconsole*help_window*html*header1Font: -adobe-helvetica-bold-r-normal-*-18-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window level 1 headers.
     <p>
<dt> <tt>cconsole*help_window*html*header2Font: -adobe-helvetica-bold-r-normal-*-14-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window level 2 headers.
     <p>
<dt> <tt>cconsole*help_window*html*header3Font: -adobe-helvetica-bold-r-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window level 3 headers.
     <p>
<dt> <tt>cconsole*help_window*html*header4Font: -adobe-helvetica-bold-r-normal-*-10-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window level 4 headers.
     <p>
<dt> <tt>cconsole*help_window*html*header5Font: -adobe-helvetica-bold-r-normal-*-8-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window level 5 headers.
     <p>
<dt> <tt>cconsole*help_window*html*header6Font: -adobe-helvetica-bold-r-normal-*-7-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window level 6 headers.
     <p>
<dt> <tt>cconsole*help_window*html*addressFont: -adobe-helvetica-medium-o-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window address text.
     <p>
<dt> <tt>cconsole*help_window*html*plainFont: -adobe-courier-medium-r-normal-*-12-*-75-75-*-*-*-*</tt>
<dd> Specifies the font used for Help Window "plain" text.
     <p>
</dl>






