(emacs)Resources X


Prev: Icons X Up: Command Arguments

X Resources
===========

   Programs running under the X Window System organize their user
options under a hierarchy of classes and resources.  You can specify
default values for these options in your X resources file, usually named
`~/.Xdefaults'.

   Each line in the file specifies a value for one option or for a
collection of related options, for one program or for several programs
(perhaps even all programs).

   Programs define named resources with particular meanings.  They also
define how to group resources into named classes.  For instance, in
Emacs, the `internalBorder' resource controls the width of the internal
border, and the `borderWidth' resource controls the width of the
external border.  Both of these resources are part of the `BorderWidth'
class.  Case distinctions are significant in these names.

   In `~/.Xdefaults', you can specify a value for a single resource on
one line, like this:

     emacs.borderWidth: 2

Or you can use a class name to specify the same value for all resources
in that class.  Here's an example:

     emacs.BorderWidth: 2

   If you specify a value for a class, it becomes the default for all
resources in that class.  You can specify values for individual
resources as well; these override the class value, for those particular
resources.  Thus, this example specifies 2 as the default width for all
borders, but overrides this value with 4 for the external border:

     emacs.Borderwidth: 2
     emacs.borderwidth: 4

   The order in which the lines appear in the file does not matter.
Also, command-line options always override the X resources file.

   The string `emacs' in the examples above is also a resource name.
It actually represents the name of the executable file that you invoke
to run Emacs.  If Emacs is installed under a different name, it look
for resources under that name instead of `emacs'.

   You can tell Emacs to use a different name instead of the name of the
executable file, with the option `-name NAME'.  Then that Emacs job
uses NAME instead of `Emacs' to look up all of its option values in the
X resource file.  This option also specifies the title for the initial
frame.

   The resources that name Emacs invocations also belong to a class; its
name is `Emacs'.  To specify options for all Emacs jobs, no matter what
name is used to run them, write `Emacs' instead of `emacs', like this:

     Emacs.BorderWidth: 2
     Emacs.borderWidth: 4

   You can specify a string of additional resource values for Emacs to
use with the command line option `-xrm DATA'.  The text DATA should
have the same format that you would use inside a file of X resources.
Resources specified this way take precedence over all others.

   The following table lists the resource names that designate options
for Emacs, each with the class that it belongs to:

`background' (class `Background')
     Background color name.

`bitmapIcon' (class `BitmapIcon')
     Use a bitmap icon (a picture of a GNU) if `on', let the window
     manager choose an icon if `off'.

`borderColor' (class `BorderColor')
     Color name for external border.

`borderWidth' (class `BorderWidth')
     Width in pixels of external border.

`cursorColor' (class `Foreground')
     Color name for text cursor (point).

`font' (class `Font')
     Font name for text.

`foreground' (class `Foreground')
     Color name for text.

`geometry' (class `Geometry')
     Window size and position.

`iconName' (class `Title')
     Name to display in icon.

`internalBorder' (class `BorderWidth')
     Width in pixels of internal border.

`paneFont' (class `Font')
     Font name for menu pane titles.

`pointerColor' (class `Foreground')
     Color of mouse cursor.

`reverseVideo' (class `ReverseVideo')
     Switch foreground and background default colors if `on', use
     colors as specified if `off'.

`selectionFont' (class `Font')
     Font name for menu items.

`title' (class `Title')
     Name to display in title bar of initial Emacs frame.


automatically generated by info2www