X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/44b0225ed09cfbc6cee7ed53c630988c342df806..8d7128c46de2af10d50c1495a075d66b702f6d21:/doc/emacs/xresources.texi diff --git a/doc/emacs/xresources.texi b/doc/emacs/xresources.texi index 66281d6dbb..afd2766996 100644 --- a/doc/emacs/xresources.texi +++ b/doc/emacs/xresources.texi @@ -1,8 +1,8 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1987, 1993-1995, 1997, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1987, 1993-1995, 1997, 2001-2015 Free Software +@c Foundation, Inc. @c See file emacs.texi for copying conditions. -@node X Resources, Antinews, Emacs Invocation, Top +@node X Resources @appendix X Options and Resources You can customize some X-related aspects of Emacs behavior using X @@ -12,10 +12,10 @@ resources, as is usual for programs that use X. graphical widgets, such as the menu-bar, scroll-bar, and dialog boxes, is determined by @ifnottex -``GTK resources'', which we will also describe. +GTK resources, which we will also describe. @end ifnottex @iftex -``GTK resources''. +GTK resources. @end iftex When Emacs is built without GTK+ support, the appearance of these widgets is determined by additional X resources. @@ -27,7 +27,7 @@ system registry (@pxref{MS-Windows Registry}). * Resources:: Using X resources with Emacs (in general). * Table of Resources:: Table of specific X resources that affect Emacs. * Lucid Resources:: X resources for Lucid menus. -* LessTif Resources:: X resources for LessTif and Motif menus. +* Motif Resources:: X resources for Motif and LessTif menus. * GTK resources:: Resources for GTK widgets. @end menu @@ -47,7 +47,7 @@ its own list of resources; to update it, use the command @command{xrdb}---for instance, @samp{xrdb ~/.Xdefaults}. @cindex registry, setting resources (MS-Windows) - (MS-Windows systems do not support X resource files; on Windows, + (MS-Windows systems do not support X resource files; on such systems, Emacs looks for X resources in the Windows Registry, first under the key @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs}, which affects only the current user and override the system-wide settings, and then under @@ -238,8 +238,8 @@ this way. @ifnottex @item @code{privateColormap} (class @code{PrivateColormap}) -If @samp{on}, use a private color map, in the case where the ``default -visual'' of class PseudoColor and Emacs is using it. +If @samp{on}, use a private color map, in the case where the default +visual of class PseudoColor and Emacs is using it. @item @code{reverseVideo} (class @code{ReverseVideo}) Switch foreground and background default colors if @samp{on}, use colors as @@ -260,7 +260,7 @@ compiled with GTK+ support. @ifnottex @item @code{selectionFont} (class @code{SelectionFont}) Font name for pop-up menu items, in non-toolkit versions of Emacs. (For -toolkit versions, see @ref{Lucid Resources}, also see @ref{LessTif +toolkit versions, see @ref{Lucid Resources}, also see @ref{Motif Resources}.) @item @code{selectionTimeout} (class @code{SelectionTimeout}) @@ -370,15 +370,15 @@ elements. Default is 1. Margin of the menu bar, in characters. Default is 1. @end table -@node LessTif Resources -@appendixsec LessTif Menu X Resources -@cindex Menu X Resources (LessTif widgets) -@cindex LessTif Widget X Resources +@node Motif Resources +@appendixsec Motif Menu X Resources +@cindex Menu X Resources (Motif widgets) +@cindex Motif Widget X Resources - If Emacs is compiled with the X toolkit support using LessTif or -Motif widgets, you can use X resources to customize the appearance of -the menu bar, pop-up menus, and dialog boxes. However, the resources -are organized differently from Lucid widgets. + If Emacs is compiled with the X toolkit support using Motif or +LessTif widgets, you can use X resources to customize the appearance +of the menu bar, pop-up menus, and dialog boxes. However, the +resources are organized differently from Lucid widgets. The resource names for the menu bar are in the @samp{pane.menubar} class, and they must be specified in this form: @@ -489,7 +489,7 @@ The color for the border shadow, on the top and the left. @cindex @file{~/.emacs.d/gtkrc} file If Emacs is compiled with GTK+ toolkit support, the simplest way to -customize its GTK+ widgets (e.g.@: menus, dialogs, tool bars and +customize its GTK+ widgets (e.g., menus, dialogs, tool bars and scroll bars) is to choose an appropriate GTK+ theme, for example with the GNOME theme selector. @@ -499,7 +499,7 @@ resources are specified in either the file @file{~/.emacs.d/gtkrc} (for Emacs-specific GTK+ resources), or @file{~/.gtkrc-2.0} (for general GTK+ resources). We recommend using @file{~/.emacs.d/gtkrc}, since GTK+ seems to ignore @file{~/.gtkrc-2.0} when running GConf with -GNOME. Note, however, that some GTK themes may override +GNOME@. Note, however, that some GTK themes may override customizations in @file{~/.emacs.d/gtkrc}; there is nothing we can do about this. GTK+ resources do not affect aspects of Emacs unrelated to GTK+ widgets, such as fonts and colors in the main Emacs window; @@ -507,7 +507,7 @@ those are governed by normal X resources (@pxref{Resources}). The following sections describe how to customize GTK+ resources for Emacs. For details about GTK+ resources, see the GTK+ API document at -@uref{http://developer.gnome.org/doc/API/2.0/gtk/gtk-Resource-Files.html}. +@uref{http://developer.gnome.org/gtk2/stable/gtk2-Resource-Files.html}. In GTK+ version 3, GTK+ resources have been replaced by a completely different system. The appearance of GTK+ widgets is now determined by @@ -541,7 +541,7 @@ gtk-font-name = "courier 12" @noindent Note that in this case the font name must be supplied as a GTK font pattern (also called a @dfn{Pango font name}), not as a -Fontconfig-style font name or XLFD. @xref{Fonts}. +Fontconfig-style font name or XLFD@. @xref{Fonts}. To customize widgets you first define a @dfn{style}, and then apply the style to the widgets. Here is an example that sets the font for @@ -590,8 +590,8 @@ widget "*verticalScrollBar*" style "scroll" A GTK+ widget is specified by a @dfn{widget name} and a @dfn{widget class}. The widget name refers to a specific widget -(e.g.@: @samp{emacs-menuitem}), while the widget class refers to a -collection of similar widgets (e.g.@: @samp{GtkMenuItem}). A widget +(e.g., @samp{emacs-menuitem}), while the widget class refers to a +collection of similar widgets (e.g., @samp{GtkMenuItem}). A widget always has a class, but need not have a name. @dfn{Absolute names} are sequences of widget names or widget @@ -677,7 +677,7 @@ class @code{GtkDialog}. For file selection, Emacs uses a widget named @code{emacs-filedialog}, of class @code{GtkFileSelection}. Because the widgets for pop-up menus and dialogs are free-standing -windows and not ``contained'' in the @code{Emacs} widget, their GTK+ +windows and not contained in the @code{Emacs} widget, their GTK+ absolute names do not start with @samp{Emacs}. To customize these widgets, use wildcards like this: @@ -746,9 +746,9 @@ possible states are: This is the default state for widgets. @item ACTIVE This is the state for a widget that is ready to do something. It is -also for the trough of a scroll bar, i.e.@: @code{bg[ACTIVE] = "red"} -sets the scroll bar trough to red. Buttons that have been pressed but -not released yet (``armed'') are in this state. +also for the trough of a scroll bar, i.e., @code{bg[ACTIVE] = "red"} +sets the scroll bar trough to red. Buttons that have been armed +(pressed but not released yet) are in this state. @item PRELIGHT This is the state for a widget that can be manipulated, when the mouse pointer is over it---for example when the mouse is over the thumb in @@ -780,7 +780,7 @@ dialog. @item bg_pixmap[@var{state}] = "@var{pixmap}" This specifies an image background (instead of a background color). @var{pixmap} should be the image file name. GTK can use a number of -image file formats, including XPM, XBM, GIF, JPEG and PNG. If you +image file formats, including XPM, XBM, GIF, JPEG and PNG@. If you want a widget to use the same image as its parent, use @samp{}. If you don't want any image, use @samp{}. @samp{} is the way to cancel a background image inherited from a @@ -790,7 +790,7 @@ You can't specify the file by its absolute file name. GTK looks for the pixmap file in directories specified in @code{pixmap_path}. @code{pixmap_path} is a colon-separated list of directories within double quotes, specified at the top level in a @file{gtkrc} file -(i.e.@: not inside a style definition; see example above): +(i.e., not inside a style definition; see example above): @smallexample pixmap_path "/usr/share/pixmaps:/usr/include/X11/pixmaps" @@ -814,8 +814,8 @@ GTK-style (or Pango) font name, like @samp{Sans Italic 10}. There are three ways to specify a color: a color name, an RGB triplet, or a GTK-style RGB triplet. @xref{Colors}, for a description of color names and RGB triplets. Color names should be enclosed with -double quotes, e.g.@: @samp{"red"}. RGB triplets should be written -without double quotes, e.g.@: @samp{#ff0000}. GTK-style RGB triplets +double quotes, e.g., @samp{"red"}. RGB triplets should be written +without double quotes, e.g., @samp{#ff0000}. GTK-style RGB triplets have the form @w{@code{@{ @var{r}, @var{g}, @var{b} @}}}, where -@var{r}, @var{g} and @var{b} are either integers in the range 0-65535 -or floats in the range 0.0-1.0. +@var{r}, @var{g} and @var{b} are either integers in the range 0--65535 +or floats in the range 0.0--1.0.