Emacs/emacs/Table-of-Resources
Next: Lucid Resources, Previous: Resources, Up: X Resources [Contents][Index]
D.2 Table of X Resources for Emacs
The table below lists the X resource names that Emacs recognizes. Note that some of the resources have no effect in Emacs compiled with various X toolkits (GTK+, Lucid, etc.)—we indicate below when this is the case.
background
(classBackground
)Background color (see Colors).
bitmapIcon
(classBitmapIcon
)Tell the window manager to display the Emacs icon if ‘
on
’; don’t do so if ‘off
’. See Icons X, for a description of the icon.borderColor
(classBorderColor
)Color of the frame’s external border. This has no effect if Emacs is compiled with GTK+ support.
borderWidth
(classBorderWidth
)Width of the frame’s external border, in pixels. This has no effect if Emacs is compiled with GTK+ support.
cursorBlink
(classCursorBlink
)If the value of this resource is ‘
off
’ or ‘false
’ or ‘0
’ at startup, Emacs disables Blink Cursor mode (see Cursor Display).cursorColor
(classForeground
)Text cursor color. If this resource is specified when Emacs starts up, Emacs sets its value as the background color of the
cursor
face (see Faces).font
(classFont
)Font name for the
default
face (see Fonts). You can also specify a fontset name (see Fontsets).fontBackend
(classFontBackend
)Comma-delimited list of backend(s) to use for drawing fonts, in order of precedence. For instance, the value ‘
x,xft
’ tells Emacs to draw fonts using the X core font driver, falling back on the Xft font driver if that fails. Normally, you should leave this resource unset, in which case Emacs tries using all available font backends.foreground
(classForeground
)Default foreground color for text.
fullscreen
(classFullscreen
)The desired fullscreen size. The value can be one of
fullboth
,maximized
,fullwidth
orfullheight
, which correspond to the command-line options ‘-fs
’, ‘-mm
’, ‘-fw
’, and ‘-fh
’ (see Window Size X). Note that this applies to the initial frame only.geometry
(classGeometry
)Window size and position. The value should be a size and position specification, of the same form as in the ‘
-g
’ or ‘--geometry
’ command-line option (see Window Size X).The size applies to all frames in the Emacs session, but the position applies only to the initial Emacs frame (or, in the case of a resource for a specific frame name, only that frame).
Be careful not to specify this resource as ‘
emacs*geometry
’, as that may affect individual menus as well as the main Emacs frame.horizontalScrollBars
(classScrollBars
)If the value of this resource is ‘
off
’ or ‘false
’ or ‘0
’, Emacs disables Horizontal Scroll Bar mode at startup (see Scroll Bars).iconName
(classTitle
)Name to display in the icon.
internalBorder
(classBorderWidth
)Width of the internal frame border, in pixels.
lineSpacing
(classLineSpacing
)Additional space between lines, in pixels.
menuBackground
(classBackground
)The background color of the menus in non-toolkit versions of Emacs. (For toolkit versions, see Lucid Resources, also see Motif Resources, and see GTK resources.)
menuBar
(classMenuBar
)If the value of this resource is ‘
off
’ or ‘false
’ or ‘0
’, Emacs disables Menu Bar mode at startup (see Menu Bars).minibuffer
(classMinibuffer
)If ‘
none
’, Emacs will not make a minibuffer in this frame; it will use a separate minibuffer frame instead.paneFont
(classFont
)Font name for menu pane titles, in non-toolkit versions of Emacs. (For toolkit versions, see Lucid Resources, also see Motif Resources, and see GTK resources.)
paneForeground
(classForeground
)Foreground color for menu pane titles, in non-toolkit versions of Emacs. (For toolkit versions, see Lucid Resources, also see Motif Resources, and see GTK resources.)
pointerColor
(classForeground
)Color of the mouse cursor. This has no effect in many graphical desktop environments, as they do not let Emacs change the mouse cursor this way.
privateColormap
(classPrivateColormap
)If ‘
on
’, use a private color map, in the case where the default visual of class PseudoColor and Emacs is using it.reverseVideo
(classReverseVideo
)Switch foreground and background default colors if ‘
on
’, use colors as specified if ‘off
’.screenGamma
(classScreenGamma
)Gamma correction for colors, equivalent to the frame parameter
screen-gamma
.scrollBar
(classScrollBar
)If the value of this resource is ‘
off
’ or ‘false
’ or ‘0
’, Emacs disables Scroll Bar mode at startup (see Scroll Bars).scrollBarWidth
(classScrollBarWidth
)The scroll bar width in pixels, equivalent to the frame parameter
scroll-bar-width
. Do not set this resource if Emacs is compiled with GTK+ support.selectionFont
(classSelectionFont
)Font name for pop-up menu items, in non-toolkit versions of Emacs. (For toolkit versions, see Lucid Resources, also see Motif Resources, and see GTK resources.)
selectionForeground
(classSelectionForeground
)Foreground color for pop-up menu items, in non-toolkit versions of Emacs. (For toolkit versions, see Lucid Resources, also see Motif Resources, and see GTK resources.)
selectionTimeout
(classSelectionTimeout
)Number of milliseconds to wait for a selection reply. If the selection owner doesn’t reply in this time, we give up. A value of 0 means wait as long as necessary.
synchronous
(classSynchronous
)Run Emacs in synchronous mode if ‘
on
’. Synchronous mode is useful for debugging X problems.title
(classTitle
)Name to display in the title bar of the initial Emacs frame.
toolBar
(classToolBar
)If the value of this resource is ‘
off
’ or ‘false
’ or ‘0
’, Emacs disables Tool Bar mode at startup (see Tool Bars).tabBar
(classTabBar
)If the value of this resource is ‘
on
’ or ‘yes
’ or ‘1
’, Emacs enables Tab Bar mode at startup (see Tab Bars).useXIM
(classUseXIM
)Disable use of X input methods (XIM) if ‘
false
’ or ‘off
’. This is only relevant if your Emacs is built with XIM support. It might be useful to turn off XIM on slow X client/server links.verticalScrollBars
(classScrollBars
)Give frames scroll bars on the left if ‘
left
’, on the right if ‘right
’; don’t have scroll bars if ‘off
’ (see Scroll Bars).visualClass
(classVisualClass
)The visual class for X color display. If specified, the value should start with one of ‘
TrueColor
’, ‘PseudoColor
’, ‘DirectColor
’, ‘StaticColor
’, ‘GrayScale
’, and ‘StaticGray
’, followed by ‘-depth
’, wheredepth
is the number of color planes.
You can also use X resources to customize individual Emacs faces
(see Faces). For example, setting the resource
‘face.attributeForeground
’ is equivalent to customizing the
‘foreground
’ attribute of the face face
. However, we
recommend customizing faces from within Emacs, instead of using X
resources. See Face Customization.
Next: Lucid Resources, Previous: Resources, Up: X Resources [Contents][Index]