 


%@(#) XResedit help and text file $Revision: 1.14 $\n

 










 







 










 






























































































 





































 


















 









\node ,About xresedit
{\lmargin +1em \bold \size 14
\section About xresedit
}
\par
{\bold \ital xresedit} (X RESource EDITor) is an
interactive, graphics-based
program that allows users with minimal understanding of the DG/UX X Windows
system, Motif, or the DG/UX operating system to customize resources for their X
applications.

{\bold \ital xresedit} runs on Data General AViiON hardware under the DG/UX
system. It requires an X display device running X11R4 (or a later release) of
the X server. You may run {\bold \ital xresedit} on any AViiON server using
an X window display.

\par
Generally speaking, only those with expert knowledge of DG/UX, X, Motif and
their
X application have been able to take full advantage of resources. {\bold
\ital xresedit} overcomes this limitation by letting you manage your
application's resources confidently, as if an expert were sitting at your side.
Now you can modify resources
for a particular X application by making simple choices and selections from
{\bold \ital xresedit}'s pull-down menus.
{\bold \ital xresedit} then makes the necessary modifications to your
application's resource file automatically.

\par
Resources let you customize the 'look and feel' of your application by letting
you define, among other characteristics, its foreground and
background colors, the location of
its window on your workstation's screen, the icon associated with it and
the fonts it displays.

\par
Usually, your system manager decides what resources you can modify.
Out of the hundreds (sometimes thousands) of resources available to a
given application, usually only a few may be available for you to modify.
Restricting access to certain resources protects you from making
frustrating--and sometimes serious--configuration errors.  The results of
incorrectly configured resources can range from illegible text to program
crashes.

\par
To help you understand how resources work, you should be
familiar with the following terms: {\ital class} and {\ital instance}.  These
are
variables with which various resources are associated.
The resources
associated with
an application's class name are its {\ital default} resources.
Customarily, the class name is identical to the program name, except it
starts with an uppercase letter (for example, "Mterm"). The instance name is
used within a resource file to define separate resource settings for a
particular session, or 'instance,' of an application.
It might help to think
of an instance as a particular {\ital flavor} of a
class: while it
may share many of a given class's resources, an instance maintains its own set
of
uniquely defined resources that
you invoke from the command line with the option
{\ital -name}.  When you start
an instance of an application, the resources associated with that instance
are passed to the application, temporarily overriding
the resources associated with the
application's class.

\par
To help you understand the concept of {\ital instance}, suppose
you would like to be able to switch between your favorite application's default
(class) resources and a customized set of resources you have predefined
using {\bold \ital xresedit}.  Perhaps you want the option of running your
application using different foreground and background colors, different fonts,
or even in a different screen location.  Instances provide this flexibility.
Let us assume your application's default
background color is {\bold hot pink}.
If you start your application with the option {\bold  -name Ocean}, for
example,
and the resource {\ital Ocean*backgroundColor:} {\bold medium sea green}
has been defined in one of your
application's resource files, this particular instance of your application
displays the background color {\ital medium sea green}.  If the instance {\ital
Ocean} also designates
different fonts and screen coordinates, these changes will appear as well.

\par
When using the {\bold \ital xresedit} Help facility, double-clicking
on words that are underlined displays additional information about the
underlined word or phrase. These underlined topics, called {\ital links,}
let you quickly locate the information you need.  (You might have noticed the
link \link {Options,
Options} in an earlier paragraph.)

\par
The major links for {\bold \ital xresedit}'s Help facility
are \link {Help, About xresedit}, \link {Features, Features}, \link {Using
xresedit, Using xresedit}, \link {Menu Selections, Menu Selections}, \link
{xresedit Resources, xresedit Resources}, \link {Command Options, Command
Options}, \link {Environment, Environment} and \link {Color,
Color}.

\par
The \link {Help, About xresedit} section presents an overview of how {\bold
\ital xresedit} works: it is the section you are reading now.
The \link
{Features, Features} section highlights {\bold
\ital xresedit}'s major features. The sections \link {Using xresedit, Using
xresedit} and \link {Menu Selections, Menu Selections}
describe how you interact with the {\bold \ital xresedit} window. The
section
\link {xresedit Resources, xresedit Resources}
describes the {\bold \ital xresedit} resources and how to change them using the
{\bold \ital xresedit} window.
These resources give you the ability to customize the way you
interact with {\bold \ital xresedit}. The section \link {Command Options,
Command Options} explains the command line options that control the way 
{\bold \ital xresedit} executes. The section \link {Environment, Environment}
describes the resource variables affecting {\bold \ital xresedit}.
The section \link {Color, Color}
explains how to alter your application's foreground and
background colors to suit your tastes.

\par
The sections \link {Entering a Character
String, Strings}, \link {Entering a Numeric Value, Numeric}, \link {Defining a
Window's Screen Location, Geometry}, \link {Making a True/False Selection,
Boolean}, \link {Entering a Directory Name, Directory}, \link {Entering a
Pathname, Paths} and \link {Selecting a Value from a List, Lists} comprise
the Help messages for the Input Resource Value screens associated with {\bold
\ital xresedit}'s data types. (Note that \link {Color, Color} is also considered
a data type.)

\par
To return to the section you were reading before you clicked on a
link, press the {\bold Undo}
button at the bottom of the Help screen. Similarly, you may move to the
previous or next Help section using the 
{\bold Next} or {\bold Previous} buttons. In addition to links, you can
navigate the Help facility by using the
table of contents that appears when you click on {\ital View} at the top of the
Help screen.  From the pull-down menu that appears, click on "Table of
Contents." Alternatively, you can press
the Ctrl-T key combination at any time to view the table of contents for
{\ital \bold xresedit}. If you're not sure how to use the Help screen, you
can display information on using and customizing the Help facility by selecting
the option "Help on help" from the table of contents.


\par
\vsp +4em
\par
\center {XResedit R6.00 Pass 1.05}
\center {Copyright (C) Data General Corporation, 1993}
\center {All Rights Reserved}
\par


\node ,Features
{\lmargin +1em \bold \size 14
\section Features
}

\break
\liststart
\item *
Allows you to customize the "look and feel" of your favorite X applications.
Depending on the type of X display you use and your application's accessible
resources, you can select the colors, fonts, window location, window title,
icon and other values to suit your working style and aesthetic preferences.

\item *
Friendly, mouse-oriented graphical interface.  Pull-down menus let you
modify your application's resources simply by pointing and clicking.
Intuitive screens and time-saving facilities, such as the ability to "grab"
the resource settings you desire from other currently displayed windows,
accelerate and simplify resource management.

\item *
Flexible viewing options let you list an application's current resources
by their field content or description.

\item *
Convenient "lookup" option shows you what classes and instances exist, and
lets you select them for modification or deletion.

\item *
Resizable, relocatable windows.  You can resize and/or move the
{\bold \ital xresedit} window just as you can any other X client.

\item *
Configuration (config) files allow system managers to define which resources a
user can change, a feature that helps prevent system problems caused by
incorrectly set resources.  Config files also help maintain system integrity by
providing explicit control over the ability to manage more powerful
resources.

\item * 
A comprehensive hypertext \link {Help, About xresedit} system. The online Help
system supports 
\link {links, About xresedit} and a table of contents, giving you instant
access to the information you need.

\item * 
Access on demand. Starting {\bold \ital xresedit} in
iconified mode places it on your desktop for immediate access.
  

\listend
\vsp +4em

\node ,Using xresedit
{\lmargin +1em \bold \size 14
\section Using xresedit
}
\par
When you enter the command {\bold xresedit}, the {\bold \ital xresedit}
window appears. Its specific location, color scheme, title and other attributes
depend
upon how
{\bold \ital xresedit's} own resources have been defined by your system
administrator. You may
override some of these default resources by specifying options on the
\link {command line, Command Options}, by modifying {\bold \ital xresedit}'s
\link {resources, xresedit Resources} using {\bold \ital xresedit}, or by
creating your own
instance of {\bold \ital xresedit}.

\par
The {\bold \ital xresedit} window is illustrated by the diagram below. This
example assumes you have entered the command {\bold xresedit -class Mterm -in
Ocean}. This command tells {\bold \ital xresedit} that you want to view and
possibly
change the resources
associated with the instance of {\bold Mterm} named {\ital Ocean}.
(Your installation's version of {\bold \ital xresedit} may not display the same
resources shown in this illustration.)

\break
{
\vsp +2em
\hsp 5em
\box 55em,60em
\vsp +4em
\hrule 54.75em
\vsp +4em
\hrule 54.75em
\vsp +5em
\hsp 8em
\box 20em,5em
\hsp 37em
\box 20em,5em
\vsp +8em
\hsp 20em
\box 20em,5em
\vsp +8em
\hsp 8em
\box 48em,15em
\vsp +20em
\hsp 8em
\box 48em,8em
\vsp -50em
\hsp 30em xresedit
\vsp +4em
\hsp 8em File
\hsp +4em Options
\hsp +32em Help
\vsp +5.5em
\hsp 8em Class Name:
\hsp +20em Instance Name:
\vsp +4em
\hsp 9em Mterm
\hsp +24em Ocean
\vsp +8em
\hsp 8em Resources:
\hsp +7em Load Resources
\vsp +7em
\hsp 9em Foreground color: white
\hsp +28em ^
\vsp +2em
\hsp 9em Background color: medium sea green
\vsp +2em
\hsp 9em Geometry: 80x24+0+200
\vsp +2em
\hsp 9em Font size: 14
\vsp +2em
\hsp 9em Scroll mode: smooth
\vsp +2em
\hsp 9em Emulation mode: vt100
\vsp +2em
\hsp 9em Lines of history: 500
\hsp +30.5em v
\vsp +5em
\hsp 8em Explanation:
\vsp +3em
\hsp 9em Define the size and location of the main
\hsp +17em ^
\vsp +2em
\hsp 9em window.
\vsp +3em
\hsp 54em v
\vsp -27em
\hsp 53em
\vrule 14.8em
\vsp +10em
\vsp +10em
\hsp 53em
\vrule 7.8em
\vsp +10em
\vsp -25em
\hsp 53em
\hrule 2.8em
\vsp +2em
\hrule 2.8em
\vsp +22em
\break
}

\par
Clicking once on the Class Name dialog box lets you enter the name of a
different application class to customize (that is, different from the one you
specified on the command line with the {\ital -class} option, if any).
Alternatively, you may use the \link {Classes..., Menu Selections} option
under the File menu to select
the class name whose resources you want to change.

\par
Clicking once on the Instance Name dialog box lets you enter a different
instance name for the application referenced in the Class Name dialog box.
Alternatively, you may use the \link {Instances..., Menu Selections} option
under the File menu to
select
the instance name whose resources you want to change. You
may create as many instances of an application as you like, each with unique
resource settings.

\par
Clicking once on a resource highlights it and displays its help message in the
Explanation box. Double-clicking on a resource displays the pop-up dialog box
associated with that resource type.  (The same effect is achieved by clicking
once on the resource and pressing the Enter key.)  See the section "How to
Change a Resource," below.

\par
Regardless of the resource type you are setting, the buttons at the bottom of
the Input Resource Value screens always have the same meaning:
\liststart
\vsp +4em
\lmargin +4em

\item OK
Accept your changes and return to the {\bold \ital xresedit} window.

\item Cancel
Do not change the resource; return to the {\bold \ital xresedit} window.

\item Delete
Delete the resource from your app-defaults file.  This button is active
only if the resource has been set in your local app-defaults file.

\item
Help
This button displays more information on {\bold \ital xresedit} and the current
screen.
\listend
\lmargin -4em 
\vsp +4em

\par
{\ital \bold How to Change a Resource}
\par
When you start {\bold \ital xresedit}, the message
"Building list of user editable resources" appears, followed by
the {\bold \ital xresedit} window.
A list of the resources you can change for the specified class and instance and
their current
values is displayed. The manner in which the resources are
listed--by resource description or the actual resource setting--is selectable.
Specifying the {\ital -dr} option on the {\bold \ital xresedit} command
line
displays resources by their actual setting.
The View selection under
the \link {Options menu, Menu Selections} provides
the same capability.

\par
Locate and highlight the resource with the mouse or
cursor positioning
keys, using the vertical scroll bar if the resource list extends
beyond the
Resources window.  (An explanation of the resource appears in the Explanation
box.) Double-click on the highlighted resource to select it: the
"Input Resource Value" window appears.

\par
The method you use to change a resource's setting varies according to the
type of resource you want to modify.  The way you interact with the
various resource screens is intuitive and forgiving. You can change a value
as many times as you like before clicking on the "OK" button to accept it. You
also may cancel your selection and exit from the current "Input Resource Value"
screen at any time.

\par
{\bold \ital xresedit} recognizes three groups of data types.  These groups
comprise the following individual data types: font; string, numeric, geometry,
and Boolean; and directory, path list and color. {\bold \ital xresedit} uses
these
data types
to request your
input for various resources. The font data type is used to
specify fonts for a given application.  Other Input Resource Value screens
require you to enter a
\link {character string, Strings} or one or more \link {numeric values,
Numeric}, to specify \link {geometric, Geometry} window coordinates, or
to mark a toggle box \link {True or False, Boolean}.
You define other resources by specifying a \link {directory, Directory} or
\link {pathname, Paths}; by selecting a numeric or character string from a
\link {list, Lists}; or by designating foreground and background \link {color,
Color} for your application.
(The
\link {color, Color} and \link {geometry, Geometry}
resources support "grabbing"; this concept is explained below.)
In some cases, you can select numeric values
by moving the mouse cursor along a slide bar. This method is useful, for
example, when you are modifying a resource that determines the number of
history lines to save. In
other cases, you select the value you want by highlighting it.

\par
The ability to "grab," or capture, color and geometric resource settings from
currently
displayed
windows is
one of {\bold \ital xresedit}'s time-saving features.
This facility lets you move your mouse cursor to a currently displayed
window and click on the desired attribute (for instance, a background color).
"Grabbing" is especially useful for
transferring a window's precise location, or for duplicating a particular
color. Using the \link {Grab bar, Color}, you can copy a screen location or
particular color rather than having to redefine it for a new class or instance.

\par
You can change resources for other classes and instances without exiting from
the {\ital \bold xresedit} window, either by clicking on the
"Load Resources" button or by selecting the Load Resources menu item under the
File menu; see the following section.

\par
When you have completed modifying a resource, close its Input Resource Value
screen by clicking on the OK button.  To exit the {\bold \ital xresedit} window
and save your changes to your local app-defaults file, select the Exit option
from the File menu.

\vsp +4em

\node ,Menu Selections
{\lmargin +1em \bold \size 14
\section Menu Selections
}
\par
The menu selections for {\bold \ital xresedit} are File, Options and Help.
Clicking once on these selections in the menu bar displays pull-down
menus, which are described below.  The menu selections require you
to specify the class name and
instance name, if applicable, either on the {\bold \ital xresedit} command line,
or using the Class Name and Instance Name fields in {\bold \ital xresedit}'s
window.
\par
{\bold File}
\par
\lmargin +4em
\liststart
\item Classes...
The Classes... menu item displays a list of the class names available to you
for resource modification.
You can select the
class name whose resources you
want to modify, or delete it.  Click once on this option to display the Select
Class Name
window.  Highlight the name of the class whose resources you want to change
and click on the OK button.  The {\bold \ital xresedit} window reappears, from
which you can load the resources for the class you have selected.

\par
To delete a class from your app-defaults directory as specified by
XUSERFILESEARCHPATH, select it and click the
Delete button.

\item Instances...
The Instances... menu item displays a list of the instance names defined in
your local copy of the app-defaults system resource file.  You can
select the instance name whose resources you
want to modify, or delete it.  Click once on this option to display the Select
Instance Name
window.  Highlight the name of the instance whose resources you want to change
and click on the OK button.  The {\bold \ital xresedit} window reappears, from
which you can load the resources for the instance you have selected.

\par
To delete an instance from your app-defaults file for this class (application),
select it and click the Delete button.

\item Load Resources
The Load Resources menu item lets you display the current resource values for a
specified class and instance.  Click once on this selection to display the
resources for the currently specified class and instance.

\item Exit
Clicking on the Exit selection saves your resource settings and quits {\bold
\ital xresedit}; you are not
prompted to confirm your decision to exit {\bold \ital xresedit}.
\listend
\lmargin -4em

{\bold Options}
\par
\lmargin +4em
\liststart
\item View
The View option lets you determine how your application's current resources
will appear when you execute the Load Resources selection from the File menu,
or click on the Load Resources button.  Clicking on View displays
two options: "Display resource list as resources" (the default setting), and
"Display
resource list as descriptions."  The first option displays the actual resource
settings; the second displays a description of the resources.  For example, the
resource value for background color might appear as {\bold *foreground: blue}.
The description for the same resource might be {\bold Foreground color: blue}.

\item System
The System option lets you edit application resources that normally are
reserved for the
system manager. (These restricted resources are listed after the {\ital sys}
directive
in the application's config file.)  Note that you must have write access to the
/usr/lib/X11/app-defaults resource file for this application.
The changes you make are written to the appropriate resource file.

\par
Click on the System option to select it: the "Allow system manager privileges"
box appears. Clicking on this box displays the
application's list of
modifiable resources, including those reserved for the system manager. You now
can modify these resources just as you would any
other resources. When you are finished, your modifications are written to the
appropriate resource file.

\item Edit
The Edit option lets you edit the application's system resource file.
When you select this option,
the changes are written to
the application's {\ital system} resource file, as defined by the
XFILESEARCHPATH environment variable, instead of to your local copy of
this file, as defined by the XUSERFILESEARCHPATH environment variable.
This option is available to you only if you have write access to the
application's resource file located in /usr/lib/X11/app-defaults.
If you do not have write access to
this file, the System option is desensitized.

\par
Click on the Edit option to select it.  The following options appear:
\display
     System app-defaults file
     User app-defaults file
\displayoff
\par
Normally the "User app-defaults file" option is preselected. To edit the {\ital
system}
resource file for your application, click once on its selection box. The
resource list for your application now will display resources that normally
are hidden from the user, provided you have selected the System option under
the Options menu. To edit your local copy of the application's
resource file, click once on its selection box.

\listend
\lmargin -4em
\par
{\bold Help}
\par
\par
\lmargin +4em
When you select the \link {Help, About xresedit} menu item, the table
of contents for {\bold \ital xresedit}'s Help system appears.  Clicking on an
item in the table of contents displays information about that topic.
Once you are using the Help system, you may click on underlined topics ({\ital
links}) for additional information.


\vsp +4em

\node ,xresedit Resources
{\lmargin +1em \bold \size 14
\section xresedit Resources
}
\par
The following list briefly describes {\bold \ital xresedit}'s
resources,
their default settings and how to modify them using the {\bold \ital
xresedit} \link {window, Using xresedit}.


\par
NOTE: For simplicity's sake, the examples below refer to resources by their
description fields, not by
their field values.  Thus, for example, you are instructed to click on the
resource "Background
color" (the description field) rather than on XResedit*background (the
resource field).


\vsp +4em
\lmargin +4em
\liststart

\item {\bold XResedit*Resource: Default \norm}
{\bold Description:}

\item {\bold Window resources:}
\break

\item XResedit.geometry: 80x24+0+0
Defines the size and placement of the {\bold \ital xresedit} \link {window,
Using xresedit}. The
argument string must adhere to
the format <columns>x<rows>[+-]<xoff>[+-]<yoff>.
The use of the period (.) instead of the asterisk (*) following
the class name (XResedit) allows the Help windows to be properly sized.
\break

To change the size and location of the {\bold \ital xresedit}
window using {\bold \ital xresedit}, double-click
on the resource "Define window size and placement" to display the
Input Resource Value screen.  To define a new {\bold \ital xresedit} window
size, enter the
desired width and height.  To define a new {\bold \ital xresedit} window
location, enter the
desired values for the X (left/right) and Y (up/down) coordinates.
Alternatively, click once on the Grab bar (Press to Grab Geometry): the
cursor
becomes a cross-hair.  Move the cross-hair to a window whose size and location
you want to mimic, and click the mouse again.  The appropriate width, height,
and grid coordinates replace those on the Input Resource Value screen.
{\ital Your
target window must belong to the same class as the application whose window you
are redefining, otherwise an error message is displayed.}
When you are satisfied with the new settings, click the OK button.

\item XResedit*background: White      
Sets the background color. Double-click on the resource "Background color"
to display the Input Resource Value screen.  There are several ways to select
screen colors; click on \link {Color, Color} for more information.

\item XResedit*foreground: Black      
Sets the foreground color.
Double-click on the resource "Foreground color"
to display the Input Resource Value screen.  There are several ways to select
screen colors: Click on \link {Color, Color} for more information.

\item XResedit.title:    xresedit        
Sets the {\bold \ital xresedit} window title.  Double-click on the resource
"Window title" to display the Input Resource Value screen.  Type the name you
want to appear at the top of {\bold \ital xresedit}'s window for the particular
instance you are defining. Click the OK button to accept the new title.
(Normally, you cannot assign a window title a null value; an error
message notifies you if you try.)

\item XResedit.iconName: xresedit        
Assigns a name to the icon associated with the class or instance of {\bold
\ital xresedit} you are defining. Double-click on the resource
"Icon title" to display the Input Resource Value screen.  Type the name you
want to assign to the icon.
Click the OK button to
accept the new icon name. (Normally, you cannot assign an icon name a null
value; an error
message notifies you if you try.)

\item XResedit.iconPixmap: xresedit_icon        
Selects the bitmap for the icon you are assigning to this particular class or
instance of {\bold \ital xresedit}.  Double-click on the
resource "Icon pixmap" to display the Input Resource Value screen.
Type the name of the bitmap you want to appear when this instance of {\bold
\ital xresedit}  is
iconified.
Click the OK button to
accept the specified bitmap. (Normally, you cannot assign a bitmap a null
value; an error message
notifies you if you try.)

\listend

{\bold Other resources:}

\liststart
\item XResedit*mouseCursor: X_cursor
Selects the shape of the cursor used within {\bold \ital xresedit}'s text area. 
Valid entries include any of the standard cursor shapes listed in 
the <X11/cursorfont.h> file (minus the XC_ prefix), a bitmap file name, 
or a font name and glyph index. Double-click on the
resource "Mouse cursor" to display the Input Resource Value screen.  Use the
vertical scroll bar to view the available selections; the current cursor type
is highlighted.  Use the mouse or arrow keys to highlight the cursor you wish
to use when running the class or instance of {\bold \ital xresedit} you
currently are
defining. Click the OK button to
accept the new cursor. To assign the
mouse cursor its default value, click on the Delete button.

\item XResedit.displayRes:  True
Determines whether {\bold \ital xresedit} displays resources as descriptions or
as values. Double-click on the
resource "Display as resources" to display the Input Resource Value screen.
Clicking on the True box causes the resources for the class or instance of
{\bold \ital xresedit}
you currently are defining to be listed by the values set
in {\bold \ital xresedit}'s resource file(s).  Clicking on the False box will
display resources by
their descriptions. Click the OK button to
accept the new setting.  To reset
the resource value to its default, click on the Delete button.

\listend
\lmargin -4em 
\vsp +4em

\node ,Command Options
{\lmargin +1em \bold \size 14
\section Command Options
}
\par
{\bold \ital xresedit} can be used with several command line options.  The
following table explains the purpose of these options and provides examples.
\vsp +4em
\lmargin +4em
\liststart

\item {\bold XResedit Option \norm}
{\bold Description:}
\break

\item -sys
Permits the user to edit resources that normally are reserved for system
managers.
This option requires the user to have write privileges for the
/usr/lib/X11/app-defaults resource file.

\item -edit
Permits the user to edit the application's system resource file, rather than
his or her local copy of this file.  This option
requires the user to have write privileges for the /usr/lib/X11/app-defaults
resource file.

\item +dr
Lists an application's resources by their description (dsc) field,
which is defined in the application's config file. (Resource values
are maintained in the application's resource file or files.)
For
example, entering
the
command {\bold xresedit -class Mterm +dr} causes {\bold \ital xresedit} to
display a descriptive list of \ital Mterm \norm resources
in a format similar to the following:
\display
   Emulation mode: d216
   Define window size and placement: 81x23+239+511
   Background color: blue
   Foreground color: green
   <and so on...>
\displayoff
\item -dr
Displays a list of an application's resources using the resources (res) field,
which is defined in the application's config file. (Resource values
are maintained in the application's resource file or files.)
For example, typing the
command
{\bold xresedit -class Mterm -dr} causes {\bold \ital xresedit} to display a list of
{\bold Mterm}'s
resources in a format similar to the following:
\display
  .emulationMode: d216
  .geometry: 81x23+239+511
  *background: blue
  *foreground: green
  <and so on...>
\displayoff
\item -ver
Displays information about the current version of {\bold \ital xresedit}.

\item -iconName
Selects the icon for {\bold \ital xresedit} by its icon name.

\item -name
Specifies the instance of {\bold \ital xresedit}. This option also sets
the icon's name and the window title.

\item -title
Specifies the title of the {\bold \ital xresedit} window for the current
session.

\item -className
Identifies the application whose resources you want to create or
modify. The class name for an application usually comprises the program name
spelled with an initial uppercase letter (for example, {\bold Mterm}).

\item -instanceName
Specifies the instance of an application's class whose resources you want to
create or modify. Use this option when you want to create a new instance of
{\bold \ital xresedit}, or change resources belonging to an existing instance of
{\bold \ital xresedit}.

\item -display
Specifies the display on which {\bold \ital xresedit} should execute.

\item -geometry
Specifies the screen coordinates that determine the location of
the {\bold \ital xresedit} window for this session.  For example, the command
{\bold xresedit -class Mterm -geo +0-0} starts {\bold \ital xresedit}
in the lower left screen corner. It also specifies {\bold \ital Mterm} as the
class whose resources you want to change.

\item -fg
Specifies the foreground color for this session with {\bold \ital xresedit}.

\item -bg
Specifies the background color for this session with {\bold \ital xresedit}.

\listend
\lmargin -4em
\vsp +4em


\node ,Environment
{\lmargin +1em \bold \size 14
\section Environment
}
\par
The following list comprises the UNIX shell environment variables used
by {\bold \ital xresedit.}
\lmargin +8em
\par
\liststart
\item XUSERFILESEARCHPATH
The environment variable XUSERFILESEARCHPATH is required to locate the user's
local resource files.  The XUSERFILESEARCHPATH must include a path to the
user's own ./app-defaults directory, as well as the \%N pathname
element. An
example of XUSERFILESEARCHPATH is /udd/smith/app-defaults/\%N.
See {\bold X}(1) for more information.

\item XFILESEARCHPATH
The environment variable XFILESEARCHPATH, which is optional (it is supplied by
default), locates
system resource files.  If specified, the XFILESEARCHPATH environment variable
must include
the following path entry: /usr/lib/X11/\%T/\%N/\%S.
See {\bold X}(1) for more information.

\item XHELPPATH
You can use XHELPPATH to force {\bold \ital xresedit} to search a different
directory for the help files.
If XHELPPATH is not set, {\bold \ital xresedit} uses
/usr/opt/X11/xhelp/C/XResedit.

\listend 
\lmargin -8em
\vsp +4em


\node ,Color
{\lmargin +1em \bold \size 14
\section Color
}
\par
One of the most effective ways to reduce the eye fatigue commonly associated
with
extended workstation use is to adjust your application's foreground and
background colors to the most visually comforting scheme. {\bold \ital
xresedit}'s palette offers
a broad
array
of colors and hues with which you can experiment before making a selection.
You may decide to set up each of
your X clients and applications with unique color schemes.  Or, you may
be content to employ the same color combination for those applications you use
most frequently.

\par
You may set foreground and background colors for most X applications either
from the command line or
from the {\bold \ital xresedit} window.  (Remember that options
specified
on the command
line override resources set in your application's resource file.) After
designating the class name and instance name (if applicable) for the
program whose colors you are creating or modifying, highlight either
{\bold Background
color} or {\bold Foreground color} in the Resources box.  When you
double-click on one of these resources, a small clock is briefly displayed,
followed by the Input Resource Value
screen for choosing colors. Don't worry; while at first glance this screen
may
appear imposing, you will soon learn that using it really is quite simple.

\par
{\bold \ital xresedit} provides several ways to select colors.  The quickest way
to designate new colors for an X application is simply to "grab" (copy) them
from another application's window.  This method, of course, assumes that you
already
have defined foreground and background colors
for other X applications. To grab a color, click once on the Grab bar (Press to
Grab a
Color); the cursor assumes a cross-hair pattern.  Position the cross-hair to
a window
displaying the desired foreground color
and click once on the "target" color. (It doesn't matter if
the color you are grabbing is text or background).  The color you have
selected replaces that displayed in the Input Resource Value screen.  If you
are satisfied with your selection, click on the OK button.  Repeat this
procedure for the background color.  The next time you start this class
or instance of your application, it will employ the new color scheme.
Alternate methods for selecting colors are described in the paragraphs below.

\par
Another way to select colors is to choose from among
those displayed above the Grab bar in the Input Resource Value screen.
Clicking once on the desired color highlights the name of your selection in the
Color Selection box (located just
below the Grab bar), as well as displays the color's name in the
Color name field. Once you have made your selection, click
on the OK button. To discard your choice and start over, click on the Cancel
button.

\par
If you know the name of the color you want, you can select it by clicking on
the Color name field and typing it in.

\par
Move your mouse cursor in the vertical scroll bar and scan the list of
available colors.  As you can see, {\bold \ital xresedit}'s palette offers a
rich variety of colors, some with evocative names like "mint
cream," "alice blue" and "peach puff."  If you are curious about what, say,
"saddle brown" looks like, highlighting this selection
displays it.  While it is entertaining to experiment with bizarre color
combinations, in the
long run you will find it easier on your eyes if you select something more
mundane. Try, for example, {\ital black} on a {\ital light steel blue}
background. Once you have made your selection, click
the OK button. Click on the Cancel button to discard your choice and start
over.

\par
NOTE: Be careful when redefining color schemes for {\bold \ital xresedit}.
You may discover to your dismay that you have created an {\bold \ital
xresedit} screen you cannot read due to insufficient contrast between the
background and foreground colors. If this happens, get help from your system
manager.

\par
For more exacting users, {\bold \ital xresedit} provides the ability to
create custom colors by manipulating the Red, Green and Blue slide bars. By
adjusting the relative saturation of red, green and blue (RGB), you can create
a broad spectrum of hybrid colors from which to choose. (Note that the name of
the color
that most
closely matches the color you create is highlighted in Color Selection box,
while its hexadecimal RGB value appears in the Color name field.)
Once you
have made your color
selection, click on the OK button. Click on the Cancel button to discard your
choice and start over.

\par
If you are so inclined, you can specify foreground and background colors
by entering the desired color's hexadecimal RGB value in the
Color name field. (This value appears automatically in the Color name field
when you define a color using the sliders.)  While you can generate thousands
of RGB values, most of these hues are virtually indistinguishable from each
other. To reduce the chances of running out of color cells, the color editor
has distilled this vast array into an ample list of named colors. When you
generate or specify an RGB value, the color editor selects the color name
that most closely approximates that value.
Hence, if you use RGB values or the sliders to generate a color, select the
color name displayed in the color name field,

\par
NOTE: To make the
color editor available on 24-bit systems, you must start the X server with the
option {\bold -cc 3} on the command line. Because the color editor only
works with the X server in pseudo-color display mode, this option forces
the server to start in that mode, causing it to simulate 8-bit color
support on a 24-bit system. (The X11 command line can be
found in the /var/X11/xdm/Xservers file.)

\vsp +4em

\node ,Strings
{\lmargin +1em \bold \size 14
\section Entering a Character String
}
\par
Entering a character string is a straightforward operation: you simply type the
desired string in the selection box.  You use this method to provide {\bold
\ital xresedit}'s window title.  It also is used to
enter the icon title and pixmap for {\bold \ital xresedit}'s icon.

\vsp +4em

\node ,Numeric
{\lmargin +1em \bold \size 14
\section Entering a Numeric Value
}
\par
To enter a numeric value, move the mouse cursor to the input box and click
once to select it, then type the desired value.  If the Input
Resource Value screen displays additional input boxes (as does the {\ital
Define window size and placement} resource), enter new values in the same
manner. The latter resource features a Grab bar that lets you use your
mouse to "point and click" on a window whose screen location you want to
capture.  The target screen's coordinates then are passed automatically to the
appropriate selection boxes.  (The section on \link {Color, Color} provides
additional information on using the Grab bar.)

\par
Some screens provide a horizontal slide bar that lets you accelerate
through a range of values until you locate the one you want.
This value automatically appears in the
selection box.

\vsp +4em

\node ,Geometry
{\lmargin +1em \bold \size 14
\section Defining a Window's Size and Location
}
\par
There are two ways to chas so you can have the same instances name in more that one class.  
Applications may have several instances with names picked by the user.

\par
Editing an instance will override the resource values for the given class
of that application. You must specify the instance when starting the 
application by using the {\ital -name \bold instance_name} switch.

\par
For example, you may wish most {\bold \ital xterm} windows to have green
letters but the console {\bold \ital xterm} to have red letters.  In that 
case you would select the class {\bold \ital XTerm} and change the 
{\ital Foreground color} resource to {\ital green} and then select the instance
{\bold \ital console} and change the {\ital Foreground color} resource to
{\ital red}.  You would then start {\bold \ital xterm} with the command line:
{\bold xterm -name console &}

\vsp +4em

 


%@(#) xresedit message file $Revision: 1.19 $\n






 







 










 






























































































 





































 

















 



\message 82 
Select Class Name\0

\message 83 
Select Instance Name\0

\message 64 
Unkown error encountered.\0

\message 1 
Can't find message string '%s' in helpfile.\0

\message 11 
xresedit: abnormal exit - resource %s does not exist.\0

\message 23 
Out of memory.\0

\message 78 
This request cannot be completed
until you have supplied a Classname.\0

\message 79 
This request cannot be completed
until you have supplied an Instancename.\0

\message 80 
Your are about to delete a resource class. This will delete your local
version of the resource file. The next time you start an application
of this class, it will use the system resource file. This action
cannot be undone.\0

\message 81 
Your are about to delete an instance of a resource class. 
This action cannot be undone.\0

\message 18 
xresedit: abnormal exit - can't find widget %s.
You may have an old resource file (XResedit) on your system somewhere 
that needs to be deleted.\0

\message 2 

      Executable path:  %s

\message 5 
   Executable version:  %s

\message 6 
             Build id:  %s

\message 3 
           Date built:  %s

\message 8 
Resource file version:  %s

\message 7 
    Help file version:  %s\010

\message 14 
Can't open icon bitmap file; using xresedit icon instead.\0

\message 16 
Insufficient memory allocation for
icon bitmap, using xresedit icon instead.\0

\message 15 
Icon bitmap file contains invalid
data; using xresedit icon instead.\0

\message 19 
Invalid color specification. 
Enter a color name or rgb value (#rrbbgg).\0

\message 20 
Write access denied to:
%s
No changes have been made.\0

\message 28 
xresedit: Invalid command line argument: %s\0

\message 53 
%s
is in use. You can not modify it now.
Please try again later.\0

\message 54 
The system resource file could not be found using your 
XFILESEARCHPATH environment variable. Please make 
sure the class name entered is correct and that 
XFILESEARCHPATH is set correctly. It is currently set to:
%s\0

\message 55 
The resource file could not be created using your 
XUSERFILESEARCHPATH environment variable. This could
be a problem with your XUSERFILESEARCHPATH setting ; the 
directory may not exist ; or the directory permissions
are incorrect. Your XUSERFILESEARCHPATH is set to: 
%s\0

\message 75 
Your copy of the resource file could not be found.
Would you like to create one?\0

\message 21 
There is no config file for the classname you specified.
The default config file (XReseditDefault) will be used.\0

\message 76 
The environment variable XUSERFILESEARCHPATH has not been set. XResedit
requires XUSERFILESEARCHPATH to be set. The recommended setting for
XUSERFILESEARCHPATH is $HOME/app-defaults/%N. More information
about XUSERFILESEARCHPATH can be found in the Xresource manpage. 
Information about how to set XUSERFILESEARCHPATH can be found in the
manpage of the shell you are using (csh, sh, etc.).\0

\message 22 
There is no config file for the classname (application) you specified.
The default config file (XReseditDefault) does not exist either.
You can not edit any resources for this classname. XResedit will exit.
You should verify that your XFILESEARCHPATH is set correctly and that
the xresedit config file directory exists. See the xresedit manpage for more
information about XFILESEARCHPATH. Contact your system administrator 
for more help.\0

\message 12 
X I/O error\0

\message 13 
%s: X error code %s\0

\message 51 
The config file has been modified during this session.
Please re-enter the Class name and Instance name before
continuing.\0

\message 27 
The config file contains an invalid command.
The line number is %d.
The invalid line is:
%s %s\0

\message 60 
The config file contains an invalid res entry.
No resource is defined after the 'res' command.
The line number is %d.
The invalid line is:
%s %s\0

\message 31 
The config file contains an invalid resource definition.
The trailing ']' is missing from the def field, or there
is a '[' that should be a '[['.
The line number is %d.
The invalid line is:
%s %s\0

\message 42 
The config file contains a reference to a definition (def) record
that doesn't exist. The missing def is:
%s\0

\message 32 
The config file contains an invalid typ definition.
The line number is %d.
The invalid line is:
%s %s\0

\message 29 
The config file contains a resource that doesn't
have a description field. The description should
have been in line number %d.\0

\message 34 
This resource requires an numeric entry.
The data entered is not a valid number.\0

\message 33 
The value entered is not within the valid range.
The minimum allowed value is %d. The Maximum allowed
value is %d.\0

\message 35 
This resource only allows simple names.
You cannot use the '/' character.\0

\message 36 
The path entered is not to a directory.\0

\message 66 
This resource requires write access to the entered path.
You do not have write access to the entered path.\0

\message 52 
No changes have been made. You do not
have write access to the resource file:
%s\0

\message 37 
You do not have write access to:
%s\0

\message 40 
You do not have read access to:
%s\0

\message 38 
You do not have access to:
%s\0

\message 39 
This file does not exist and is required:
%s\0

\message 65 
The path entered is invalid.\0

\message 41 
This resource does not allow the use
of the '~' character in the pathname.\0

\message 43 
Invalid entry. The data entered does not satisfy the
regular expression string defined in the config file:
%s\0

\message 44 
XResedit could not fork another process.
Contct your system administrator.\0

\message 46 
Can't open a pty.\0

\message 47 
Can't duplicate stdin/stdout/stderr.\0

\message 48 
Can't exec 'xfontsel'. Pleas Contact
your system manager for more help.\0

\message 59 
Can't exec 'appres'. Please Contact
your system manager for more help.\0

\message 50 
An entry is required.\0

\message 57 
XResedit can't modify this resource.
Please read the explanation for
this resource at the bottom of the
xresedit window.\0

\message 45 
XResedit can't open a temporary file in /tmp.
Please contact your system administrator
for help.\0

\message 58  
XResedit was unable to determine the value of the resources.
This could be caused by a lack of disk space in /tmp, or
no read/write permissions in /tmp.\0

\message 67 
A null entry is not allowed for this resource.
Consider using the 'Cancel' option if you don't
want this resource set.\0

\message 63 
<Not Set>\0

 
\message 49 
*title:XResedit Font Selection\0

\message 84 
The font name is invalid.

\message 85 
Unable to initialize xresedit configuration files.
The most likely cause is a bad XFILESEARCHPATH.
Attempting to initialize with standard settings.\0

\message 86 
Unable to initialize xresedit configuration files 
using the standard XFILESEARCHPATH.  You should
contact your system adminstrator for more help.\0

\message 4 
%s\0

\message 68 
Window size (in pixels)\0

\message 69 
Window size (in characters)\0

\message 70 
Can't grab mouse.\0

\message 71 
Building list of user editable resources...\0

\message 87 
Enter a class name. Usually the class name for a program is the program name with the first character of every 'word' in the name capitalized (i.e. XTerm). Some applications only capitalize the first character of the program name (i.e. Mterm). If you do not know what class names are on your system, you can use the 'File/Classes...' menu item to list the available classes on your system. For more information use the 'Help' menu item and the manpage.\0

\message 88 
Enter an instance name. The instance name is used on the command line with the -name command line option to signify a specific instance of an application. Defining instances of an application lets you have multiple personalities for each application. Most often instance names are not used, and you may simply press ENTER for this field. If you do not know what instances have been defined for a class you can use the 'File/Instances...' menu item to list the available instances for the desired class. For more information use the 'Help' menu item and the manpage.\0

 


\message 61 
#CANCEL#\0

\message 62 
#DELETE#\0

\message 9 
R6.00_1.05\0







% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Help System "Help on Help"
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\node About Help
\level 1
\section The Help System,no-text,hide-toc-children
\level 2
\section About Help,no-text,hide-toc-children

The help system provides a way for you to view information, including
application information, links between related ideas, a history
facility, a table of contents, and resource specification capabilities.

You can click on any of the following topics for more information:

{\lmargin 0.30in
\parindent 0in
{\fontspec symbol } \link {Using Help,Using Help}

{\fontspec symbol } \link {Customizing Help,Customizing Help}}

A {\ital help document} contains information about an
application (such as Mterm or Mxdb) and is organized into sections,
like a book.  As within a book, sections in a help document may be
divided into more sections, which may be divided into more sections
yet. The table of contents lists the help document's contents by
sections.

The information contained in a help document is divided into
{\ital nodes}.  Nodes correspond to the pages of a book.
These "pages" of information are displayed in the help display area.

There is often a connection from a phrase in one section of a help
document to related text in another section. These connections are
known as {\ital links}. Underlined text in the help
display window indicates a link to related text elsewhere in the help
document.

\node
\level 2
\section Using Help,no-text,hide-toc-children

This section describes the user interface components of the help system.
The main window appears when your application program calls the help
system.  The window consists of four main areas: the menu bar, the node
title area, the help display area, and the control panel.  These areas are
illustrated in the diagram below.  For more information about any area
click on it's underlined label.

\break
\break
{\lmargin 0.80in
\box 6in,7in,0.03in
\lmargin +0.1in
\vsp +0.1in
\box 5.82in,0.4in,0.03in
\size 14
\vsp -0.16in
\bold \lmpos 21em \link{Menu Bar,The Menu Bar}
\break
\box 5.82in,0.4in,0.03in
\vsp -0.16in
\lmpos 21.2em \link{Title Area,Node Title Area}
\break
\box 5.82in,5.4in,0.03in
\vsp +2.2in
\lmpos 17.2em \link{Help Display Area,Help Display Area}
\break
\vsp +2.65in
\box 5.82in,0.4in,0.03in
\vsp -0.16in
\lmpos 19em \link{Control Panel,The Control Panel}
}

\node
\level +
\section The Menu Bar,no-text,hide-toc-children

The menu bar, located at the top of the window, contains the View
and Help menus. To use a menu, move your cursor to the menu name and
press the mouse's left button. The menu will appear and show you what
commands you can choose from. To select a menu item, move your cursor
to the item and release the left button. If you don't wish to choose
an item from that menu, release the left button anywhere outside of
the menu.

You can browse through the menus in the menu bar by moving the cursor
across the menu title.

\node
\level +
\section The View Menu,no-text,hide-toc-children

The View menu contains two entries: Table of Contents and History.

\liststart

\item {\bold Table of Contents}
Choosing the Table of Contents entry displays, in a dialog box, the section
entries in the help document.  To display a section in the help display
area, move your cursor to the section entry listed in the dialog box and
double-click the left button of your mouse. Or, click the left button once
and click on the OK box with the left button.

If there are more section entries than can appear in the dialog box,
horizontal and vertical scrollbars appear.  Use scrollbars to move
text in the dialog box so that you can see the rest of the section
entries.

The help system can expand or contract the table of contents. If a
section entry in the dialog box is followed by an ellipsis, clicking
the mouse's right button on that section entry will display any hidden
subsections. Clicking the right button on an entry with subsections
beneath it will cause that portion of the table of contents to contract
and an ellipsis will appear after the section entry.  You can skim
through the contracted table of contents and then expand sections
to quickly find the information you want.

\item {\bold History} 
Choosing the History entry displays, in a dialog box, the nodes that you
have visited while using the help system.  After you visit a node, its name
is added to the bottom of the history list (it can be added to the top of
the list instead if you specify a value of True for the history.insertAtTop
resource; see the section \link{Customizing Help,Customizing Help}).

You can display a node from the history list in the help display area
by moving your cursor to the node listed in the dialog box and
double-clicking the left button of your mouse. Alternatively, click
the left button once and click on the OK box with the left button.

If there are more nodes than can appear in the dialog box, horizontal
and vertical scrollbars appear.  Use scrollbars to move text in the
dialog box so that you can see the rest of the nodes.
\listend

\node
\section The Help Menu,no-text,hide-toc-children

The Help menu contains three entries: About Help, Using Help, and
Customizing Help.

\liststart

\item {\bold About Help} 
Choosing the About Help entry displays general information about the help
system.

\item {\bold Using Help}
Choosing the Using Help entry displays information that describes how to
use the help system.

\item {\bold Customizing Help}
Choosing the Customizing Help entry display information that describes how
to change the appearance and behavior of the help system through X resource.
\listend

\node
\level -
\section Node Title Area,no-text,hide-toc-children

The node title area displays the name of the current node (as it is
displayed in the table of contents and history) and is located below
the menu bar and above the help display area.

\node
\section Help Display Area,no-text,hide-toc-children

This area of the window displays the help document, which contains
information about an application. Underlined text in the help display
window indicates a link to related text elsewhere in the help document.
To view the related information, click your mouse's left
button on the underlined text.  The new information will be displayed
in the help display area.

If the underlined phrase has more than one link associated with it,
the Node Selection dialog box will appear. This dialog box lists the
node names from which you can choose. To choose a node, move your
cursor to the node name listed in the dialog box and double-click
the left button of your mouse. Alternatively, click the left button
once and click on the OK box with the left button.

Only one Node Selection dialog box will appear for each help session.
If node selection is necessary and the dialog box already exists,
the help system replaces the node name list with a new list.   

The Node Selection dialog box will remain on the screen until you
close it, either explicitly with the Close button or implicitly by
closing the help system or exiting from the application program. You
might want to move the dialog box out of the help display area; with
most window managers, move your cursor to the title bar of the Node
Selection box, press and hold the left button, move the cursor to
the position where you want the dialog box, and release the button.

If the node displayed in the help display area contains more information
than can appear in the area, horizontal and vertical scrollbars appear. 
Use scrollbars to move text in the help display area so that you can
see the rest of the information.

Note that horizontally resizing the main window will not affect word
wrap margins, which are specified in the help source file. Vertically
resizing the main window will allow more information to appear in
the help display area.

\node
\section The Control Panel,no-text,hide-toc-children

The Control Panel contains four buttons: Next, Previous, Undo, and
Close.

\liststart
\item {\bold Next}
When you click the Next button, the help system displays the next
node of the help document. If there is no node after the current node,
this button's text is shaded with gray to show that the button is
inoperative.

\item {\bold Previous}
When you click the Previous button, the help system displays the previous
node of the help document. If there is no node before the current
node, this button's text is shaded with gray to show that the button
is inoperative.

\item {\bold Undo}
The help system removes the previously viewed node from the top of
the history list and displays it when you click the Undo button. If
the history list is empty, this button is shaded with gray to show
that it is inoperative.

\item {\bold Close}
To remove the help window and any help dialogs from the screen, click
the Close button. The Close button does not cause you to exit from
the application that called the help system. The help window and any
dialogs will reappear when the application calls the help system again.

\listend

\node
\section Node Selection Dialogs,no-text,hide-toc-children

{\bold Table of Contents and History Dialog Boxes:} Both
the Table of Contents and History dialog boxes will remain on the
screen until you close them, either explicitly with the Close button
or implicitly by closing the help system or exiting from the
application program.  You might want to move a dialog box out of the
help display area; with most window managers, move your cursor to the
title bar of the Table of Contents or History box, press and hold the
left button, move the cursor to the position where you want the dialog
box, and release the button.

\node
\level -
\section Customizing Help,no-text,hide-toc-children
Xhelp can be customized using command-line options and resources;  
many Xhelp features can be customized by both command-line options and  
X resources. Resources are generally useful to define several features
commonly used or used as a group. Command-line options are more useful 
for exceptions to these common features. For more information about 
resources and resource files see the man page for Xdefaults and X.

Use the following syntax for the specification of help system resources:

{
\lmargin 0.0385pw
{\ital application_name_or_class}{\bold .help.}{\ital resource_specification}

\lmargin 0.0385pw
{\ital application_name_or_class}{\bold .help*}{\ital resource_specification}
}

Placing a period between components (like {\ital
application_name_or_class}{\bold .help}\ and {\bold help.}{\ital resource_specification}) means
that the left component must be the parent of the right component.
Since each application is the parent of its help system, you would
begin an Mterm help system resource specification with "Mterm.help" and
follow that with the rest of the specification.

Placing an asterisk, which is a wildcard character, between components
(such as {\bold help*}{\ital
resource_specification}) means that the left component must be an
ancestor of the right component. This is helpful when you want to
specify a resource not just for one item, but for that item and all
the items that it contains. To specify a resource (in this example,
the foreground color) for all of an application's descendants, use
this syntax:

{
\lmargin 0.0385pw
{\ital application_name_or_class}{\bold *}{\ital foreground_specification}.
}

The {\ital resource_specification}\ variable consists of
a resource name followed by a colon, one or more spaces, and a value.
Here are some examples:

{\lmargin 0.0385pw \fontspec example
Mterm.help*foreground: dark slate gray\break
Mterm.help*background: light blue\break
Mterm.help.history.insertAtTop: True}

The first example above specifies that the foreground color
of Mterm's help system, including all of its descendants, will be dark
slate gray. The second example specifies that the background color
for Mterm's help system will be light blue. The last example specifies
that new history items in Mterm's help system will be added to the
top of the history list.

Explicitly stated resource specifications take precedence over general
resource specifications, as shown in the following list:

{\lmargin 0.0385pw \fontspec example
Application.help.item.resource  \lmpos 35em (highest precedence)\break
Application.help.item*resource\break
Application.help*resource\break
Application*resource \lmpos 35em (lowest precedence)}


If neither you nor an application's help system does not specify a
particular resource for the help system, the value for that resource
is, by default, the application's value for that resource. For instance,
if you do not specify a foreground color for Mterm's help system, but
did specify black for Mterm's foreground color, the Mterm help system's
foreground color will be black.

Some common resources are described below, in alphabetical order.

\node
\level +
\section Specifying the Background Color,no-text,hide-toc-children

The background color determines the color of everything except text.
The default is white for monochrome displays and blue for color displays.
This example specifies that the background color for Mterm's help system
will be light blue:

{\lmargin 0.0385pw \fontspec example
Mterm.help*background: light blue}

To make the background color for all help windows light blue, use
this specification:

{\lmargin 0.0385pw \fontspec example
*help*background: light blue}

See the {\bold rgb.txt}\ file, usually located in {\bold /usr/lib/X11},
for the list of colors to choose from.

\node 
\section Specifying Fonts,no-text,hide-toc-children

The fontList resource specifies the font for text in the help system
window; if you do not specify a font, the window will contain text
in the default font, which is the first font in the application's
fontList.

You can use any valid font description as the value for this resource;
use the {\bold xlsfonts}\ command to list the valid
fonts. Note that the font size will affect the size of the window
frame and its menus.

This example specifies that the font for the Mterm help system's
interface (including menus, labels, and button names) will be 9x15;
use the asterisk to denote that this font applies for the help system
window and all of its subwindows:

{\lmargin 0.0385pw \fontspec example
Mterm.help*fontList: 9x15}

The next example specifies some fonts for the help system's help text,
located in the ViewWindow area (the ViewWindow area is the area of
each window in which you view text). The ViewWindow area supports
named fonts for various classes of text. Except for "default,"
classes are application defined.

{\lmargin 0.0385pw \fontspec example
Mterm.help.viewWindow.fontList: \\\break
\lmpos 5em  *courier*medium-r*12*=default, \\\break
\lmpos 5em *courier*medium-r*12*=normal, \\\break
\lmpos 5em *courier*medium-o*12*=italic, \\\break
\lmpos 5em *courier*bold-r*12*=bold
}

The font named "default" will be used when the system cannot find
a referenced font.

\node
\section Specifying the Foreground Color,no-text,hide-toc-children

The foreground color is the color in which the text in the help system's
window and menus is displayed. For example, the foreground color determines
the color of the menu name "View" and the color of the options
listed in that menu. The default is black for both monochrome and 
color displays. This example specifies that the foreground color of
Mterm's help system will be dark slate gray:

{\lmargin 0.0385pw \fontspec example
Mterm.help*foreground: dark slate gray}

To make the foreground color for all help windows dark slate gray,
use this specification:

{\lmargin 0.0385pw \fontspec example
*help*foreground: dark slate gray}

See the {\bold rgb.txt}\ file, usually located in
{\bold /usr/lib/X11}, for the list of colors to choose
from.

\node
\section Specifying Window Size and Placement,no-text,hide-toc-children

The geometry resource specifies the size and placement of the help
system window. The value of {\ital geometry}\ is

{\lmargin 0.0385pw \fontspec example
[{\ital width}{\bold x}{\ital height}][{\bold +}{\ital xoff}{\bold +}{\ital yoff}]
}

The {\ital width}\ and {\ital height}\
values are the dimensions of the help system window. The\  {\ital xoff}\ (x-offset) and {\ital yoff}\ (y-offset)
values determine the window's location. All of the values are in
pixels.

A positive x-offset specifies the distance that the left
edge of the window is offset from the left side of the display, while
a negative x-offset specifies the distance the right edge of the
window is offset from the right side of the display. A positive y-offset
specifies the distance that the top edge of the window is offset from
the top of the display, while a negative y-offset specifies the
distance that the bottom edge of the window is offset from the bottom
of the display.

If you specify the window size but not the location, you must move
the window to its location . If you specify the location but not the
window size, the help system window uses the default size of 602 pixels
by 811 pixels.

The following example will place a 800 pixel by 800 pixel help system
window in the upper left corner (10 pixels from both the left and
top edges) of the display when the application program (Mterm in this
case) calls the help system:

{\lmargin 0.0385pw \fontspec example
Mterm.help.geometry: 800x800+10+10}

\node
\section Specifying History Item Insertion,no-text,hide-toc-children

The history.insertAtTop resource specifies where new history items
will be inserted. If this resource's value is True, new history items
are added to the top of the history list. If the value is False, items
are inserted at the bottom. This example would cause new history items
in Mterm's help system will be added to the top of the history list:

{\lmargin 0.0385pw \fontspec example}
Mterm.help.history.insertAtTop: True}

\node ,,_none
\section Specifying Scrollbar Placement,no-text,hide-toc-children

The scrollbarPlacement resource specifies where the help system's
scrollbars will be placed in the help system window.  The value of
{\ital scrollbarPlacement}\ is

{\lmargin 0.0385pw \fontspec example
{\ital verticalplacement}{\bold _}{\ital horizontalplacement}}

The value of {\ital verticalplacement}\ can be TOP or
BOTTOM. The value of {\ital horizontalplacement}\ can be
LEFT or RIGHT.

This example will place scrollbars at the top and right side of Mterm's
help system window:

{\lmargin 0.0385pw \fontspec example
Mterm.help*scrollbarPlacement: TOP_RIGHT}

% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Help System Error Messages
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\message Fatal Error
Fatal Error
\message Error
Error
\message Warning
Warning
\message Debugging
Debug
\message Parse Error
Parse Error
\message UI Error
UI Error
\message Default Error
Default Error
\message parse_begin_wo_end
Node %s: No end group (}) found for begin group ({) on line %d
\message parse_end_before_begin
Node %s: Extra end group (}) found on line %d
\message parse_unexpected_eol
Node %s: Unexpected text on line %d before end of line
\message parse_invalid_unit
Node %s: Invalid unit encountered on line %d
\message parse_invalid_style
Node %s: Invalid style encountered on line %d
\message parse_no_left_brace
Node %s: Link token encountered on line %d with no begin group
\message parse_no_right_brace
Node %s: Link token encountered on line %d with no end group
\message parse_unexpected_end_of_node
Node %s: Unexpected end of node encountered on line %d
\message parse_unexpected_end_of_draw
Node %s: Unexpected end of drawing command encountered on line %d
\message parse_invalid_token
Node %s: Invalid token %s encountered on line %d
\message parse_invalid_command_placement
Node %s: Invalid command placement on line %d
\message parse_display_before_end_display
Node %s: Display before end display encountered on line %d
\message parse_end_display_before_display
Node %s: End display encountered before display on line %d
\message parse_display_wo_end_display
Node %s: Display without end display encountered on line %d
\message parse_number_out_of_range
Node %s: Number out of range on line %d
\message parse_bad_node_token
Node %s: Invalid node command encountered on line %d
\message parse_no_node_name
Node %s: No node or section name found
\message parse_begin_end_consistency
Node %s: Grouping level after item must be the same as before on line %d
\message parse_invalid_argument
Invalid argument encountered on line %d
\message parse_invalid_section_command
Invalid section command encountered on line %d
\message parse_bad_node_command
Invalid node command format on line %d
\message parse_bad_draw_command
Invalid draw command format on line %d
\message parse_too_many_levels
Too many list levels on line %d
\message ui_load_font_bad_name
Font %s not found
\message ui_unable_to_create_gc
Unable to create graphics context
\message default_get_node_error
Unable to get node %s
\message last_message_to_avoid_evil_bug
bogus


