[Emacs-commit] Changes to xresmini.texi

[Jan Djärv]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Jan Djärv <jhd>        06/11/18 14:49:07

Index: xresmini.texi
===================================================================
RCS file: xresmini.texi
diff -N xresmini.texi
--- xresmini.texi       24 Jul 2006 17:47:53 -0000      1.6
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,432 +0,0 @@
address@hidden This is part of the Emacs manual.
address@hidden Copyright (C) 1987, 1993, 1994, 1995, 1997, 2001, 2002, 2003,
address@hidden   2004, 2005, 2006 Free Software Foundation, Inc.
address@hidden See file emacs.texi for copying conditions.
address@hidden X Resources, Antinews, Emacs Invocation, Top
address@hidden X Options and Resources
-
-  You can customize some X-related aspects of Emacs behavior using X
-resources, as is usual for programs that use X.  On MS-Windows, you
-can customize some of the same aspects using the system registry.
address@hidden Registry}.  Likewise, Emacs on MacOS Carbon emulates X
-resources using the Preferences system.  @xref{Mac Environment Variables}.
-
-  When Emacs is built using an ``X toolkit,'' such as Lucid or
-LessTif, you need to use X resources to customize the appearance of
-the widgets, including the menu-bar, scroll-bar, and dialog boxes.
-This is because the libraries that implement these don't provide for
-customization through Emacs.  GTK+ widgets use a separate system of
-``GTK resources.''  In this chapter we describe the most commonly used
-resource specifications.  For full documentation, see the online
-manual.
-
address@hidden Add xref for LessTif/Motif menu resources.
-
address@hidden
-* Resources::           Using X resources with Emacs (in general).
-* Table of Resources::  Table of specific X resources that affect Emacs.
-* Face Resources::      X resources for customizing faces.
-* Lucid Resources::     X resources for Lucid menus.
-* GTK resources::       Resources for GTK widgets.
address@hidden menu
-
address@hidden Resources
address@hidden X Resources
address@hidden resources
address@hidden X resources
address@hidden @file{~/.Xdefaults} file
address@hidden @file{~/.Xresources} file
-
-  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 @file{~/.Xdefaults} or @file{~/.Xresources}.
-If changes in @file{~/.Xdefaults} do not
-take effect, it is because your X server stores its own list of
-resources; to update them, use the shell command @command{xrdb}---for
-instance, @samp{xrdb ~/.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
-(optionally even for all programs).
-
address@hidden Registry (MS-Windows)
-  MS-Windows systems don't support @file{~/.Xdefaults} files, but
-Emacs compiled for Windows looks for X resources in the Windows
-Registry, under the key @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs}
-and then under the key @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}.
-The menu and scrollbars are native widgets on MS-Windows, so they are
-only customizable via the system-wide settings in the Display Control
-Panel.  You can also set resources using the @samp{-xrm} command line
-option (see below.)
-
-  Applications such as Emacs look for resources with specific names
-and their particular meanings.  Case distinctions are significant in
-these names.  Each resource specification in @file{~/.Xdefaults}
-states the name of the program and the name of the resource.  For
-Emacs, the program name is @samp{Emacs}.  It looks like this:
-
address@hidden
-Emacs.borderWidth: 2
address@hidden example
-
-  The order in which the lines appear in the file does not matter.
-Also, command-line options always override the X resources file.
-
-  You can experiment with the effect of different resource settings
-with the @code{editres} program.  Select @samp{Get Tree} from the
address@hidden menu, then click on an Emacs frame.  This will display
-a tree showing the structure of X toolkit widgets used in an Emacs
-frame.  Select one of them, such as @samp{menubar}, then select
address@hidden Resource Box} from the @samp{Commands} menu.  This displays
-a list of all the meaningful X resources for that widget, and allows
-you to edit them.  Changes take effect when you click on the
address@hidden button.  (See the @code{editres} man page for more
-details.)
-
address@hidden Table of Resources
address@hidden Table of X Resources for Emacs
-
-  This table lists the resource names that designate options for
-Emacs, not counting those for the appearance of the menu bar, each
-with the class that it belongs to:
-
address@hidden @asis
address@hidden @code{background} (class @code{Background})
-Background color name.
-
address@hidden @code{borderColor} (class @code{BorderColor})
-Color name for the external border.
-
address@hidden @code{cursorColor} (class @code{Foreground})
-Color name for text cursor (point).
-
address@hidden @code{font} (class @code{Font})
-Font name (or fontset name, @pxref{Fontsets}) for @code{default} font.
-
address@hidden @code{foreground} (class @code{Foreground})
-Color name for text.
-
address@hidden @code{geometry} (class @code{Geometry})
-Window size and position.  Be careful not to specify this resource as
address@hidden, because that may affect individual menus as well
-as the Emacs frame itself.
-
-If this resource specifies a position, that position applies only to the
-initial Emacs frame (or, in the case of a resource for a specific frame
-name, only that frame).  However, the size, if specified here, applies to
-all frames.
-
address@hidden @code{iconName} (class @code{Title})
-Name to display in the icon.
-
address@hidden @code{internalBorder} (class @code{BorderWidth})
-Width in pixels of the internal border.
-
address@hidden @code{lineSpacing} (class @code{LineSpacing})
address@hidden line spacing
address@hidden leading
-Additional space (@dfn{leading}) between lines, in pixels.
-
address@hidden @code{menuBar} (class @code{MenuBar})
address@hidden menu bar
-Give frames menu bars if @samp{on}; don't have menu bars if
address@hidden  @xref{Lucid Resources}, for how to control the appearance
-of the menu bar if you have one.
-
address@hidden @code{pointerColor} (class @code{Foreground})
-Color of the mouse cursor.
-
address@hidden @code{screenGamma} (class @code{ScreenGamma})
address@hidden gamma correction
-Gamma correction for colors, equivalent to the frame parameter
address@hidden
-
address@hidden @code{title} (class @code{Title})
-Name to display in the title bar of the initial Emacs frame.
-
address@hidden @code{toolBar} (class @code{ToolBar})
address@hidden tool bar
-Number of lines to reserve for the tool bar.  A zero value suppresses
-the tool bar.  If the value is non-zero and
address@hidden is address@hidden, the tool bar's size
-will be changed automatically so that all tool bar items are visible.
-
address@hidden @code{useXIM} (class @code{UseXIM})
address@hidden XIM
address@hidden X input methods
address@hidden input methods, X
-Turn off use of X input methods (XIM) if @samp{false} or @samp{off}.
-This is only relevant if your Emacs is actually built with XIM
-support.  It is potentially useful to turn off XIM for efficiency,
-especially slow X client/server links.
-
address@hidden @code{verticalScrollBars} (class @code{ScrollBars})
-Give frames scroll bars if @samp{on}; don't have scroll bars if
address@hidden
address@hidden table
-
address@hidden Face Resources
address@hidden X Resources for Faces
-
-  You can use resources to customize the appearance of particular
-faces (@pxref{Faces}):
-
address@hidden @code
address@hidden @var{face}.attributeForeground
-Foreground color for face @var{face}.
address@hidden @var{face}.attributeBackground
-Background color for face @var{face}.
address@hidden @var{face}.attributeUnderline
-Underline flag for face @var{face}.  Use @samp{on} or @samp{true} for
-yes.
address@hidden @var{face}.attributeStrikeThrough
address@hidden @var{face}.attributeOverline
address@hidden @var{face}.attributeBox
address@hidden @var{face}.attributeInverse
-Likewise, for other boolean font attributes.
address@hidden @var{face}.attributeStipple
-The name of a pixmap data file to use for the stipple pattern, or
address@hidden to not use stipple for the face @var{face}.
address@hidden @var{face}.attributeBackgroundPixmap
-The background pixmap for the face @var{face}.  Should be a name of a
-pixmap file or @code{false}.
address@hidden @var{face}.attributeFont
-Font name (full XFD name or valid X abbreviation) for face @var{face}.
-Instead of this, you can specify the font through separate attributes.
address@hidden table
-
-  Instead of using @code{attributeFont} to specify a font name, you can
-select a font through these separate attributes:
-
address@hidden @code
address@hidden @var{face}.attributeFamily
-Font family for face @var{face}.
address@hidden @var{face}.attributeHeight
-Height of the font to use for face @var{face}: either an integer
-specifying the height in units of 1/address@hidden, or a floating point
-number that specifies a scale factor to scale the underlying face's
-default font, or a function to be called with the default height which
-will return a new height.
address@hidden @var{face}.attributeWidth
address@hidden @var{face}.attributeWeight
address@hidden @var{face}.attributeSlant
-Each of these resources corresponds to a like-named font attribute,
-and you write the resource value the same as the symbol you would use
-for the font attribute value.
address@hidden @var{face}.attributeBold
-Bold flag for face @var{face}---instead of @code{attributeWeight}.  Use 
@samp{on} or @samp{true} for
-yes.
address@hidden @var{face}.attributeItalic
-Italic flag for face @var{face}---instead of @code{attributeSlant}.
address@hidden table
-
address@hidden Lucid Resources
address@hidden Lucid Menu X Resources
address@hidden Menu X Resources (Lucid widgets)
address@hidden Lucid Widget X Resources
-
-  If the Emacs installed at your site was built to use the X toolkit
-with the Lucid menu widgets, then the menu bar is a separate widget
-and has its own resources.  The resource specifications start with
address@hidden instance, to specify the font
address@hidden for the menu-bar items, write this:
-
address@hidden
-Emacs.pane.menubar.font:  8x16
address@hidden example
-
address@hidden
-Resources for @emph{non-menubar} toolkit pop-up menus have
address@hidden instead of @samp{pane.menubar}.  For example, to specify
-the font @samp{8x16} for the pop-up menu items, write this:
-
address@hidden
-Emacs.menu*.font:      8x16
address@hidden example
-
address@hidden
-For dialog boxes, use @samp{dialog*}:
-
address@hidden
-Emacs.dialog*.font:    8x16
address@hidden example
-
address@hidden
-The Lucid menus can display multilingual text in your locale.  For
-more information about fontsets see the man page for
address@hidden  To enable multilingual menu text you specify a
address@hidden resource instead of the font resource.  If both
address@hidden and @code{fontSet} resources are specified, the
address@hidden resource is used.
-
-  Thus, to specify @samp{-*-helvetica-medium-r-*--*-120-*-*-*-*-*-*,*}
-for both the popup and menu bar menus, write this:
-
address@hidden
-Emacs*menu*fontSet:  -*-helvetica-medium-r-*--*-120-*-*-*-*-*-*,*
address@hidden example
-
address@hidden
-The @samp{*menu*} as a wildcard matches @samp{pane.menubar} and
address@hidden@dots{}}.
-
-  Experience shows that on some systems you may need to add
address@hidden@: before the @samp{pane.menubar} or @samp{menu*}.  On
-some other systems, you must not add @samp{shell.}.  The generic wildcard
-approach should work on both kinds of systems.
-
-  Here is a list of the specific resources for menu bars and pop-up menus:
-
address@hidden @code
address@hidden font
-Font for menu item text.
address@hidden fontSet
-Fontset for menu item text.
address@hidden foreground
-Color of the foreground.
address@hidden background
-Color of the background.
address@hidden buttonForeground
-In the menu bar, the color of the foreground for a selected item.
address@hidden margin
-The margin of the menu bar, in characters.  Default is 1.
address@hidden table
-
address@hidden GTK resources
address@hidden GTK resources
-
-  The most common way to customize the GTK widgets Emacs uses (menus, dialogs
-tool bars and scroll bars) is by choosing an appropriate theme, for example
-with the GNOME theme selector.  You can also do Emacs specific customization
-by inserting GTK style directives in the file @file{~/.emacs.d/gtkrc}.  Some 
GTK
-themes ignore customizations in @file{~/.emacs.d/gtkrc} so not everything
-works with all themes.  To customize Emacs font, background, faces, etc., use
-the normal X resources (@pxref{Resources}).  We will present some examples of
-customizations here, but for a more detailed description, see the online 
manual.
-
-  The first example is just one line.  It changes the font on all GTK widgets
-to courier with size 12:
-
address@hidden
-gtk-font-name = "courier 12"
address@hidden smallexample
-
-  The thing to note is that the font name is not an X font name, like
--*-helvetica-medium-r-*--*-120-*-*-*-*-*-*, but a Pango font name.  A Pango
-font name is basically of the format "family style size", where the style
-is optional as in the case above.  A name with a style could be for example:
-
address@hidden
-gtk-font-name = "helvetica bold 10"
address@hidden smallexample
-
-  To customize widgets you first define a style and then apply the style to
-the widgets.  Here is an example that sets the font for menus, but not
-for other widgets:
-
address@hidden
-# @r{Define the style @samp{menufont}.}
-style "menufont"
address@hidden
-  font_name = "helvetica bold 14"  # This is a Pango font name
address@hidden
-
-# @r{Specify that widget type @samp{*emacs-menuitem*} uses @samp{menufont}.}
-widget "*emacs-menuitem*" style "menufont"
address@hidden smallexample
-
-The widget name in this example contains wildcards, so the style will be
-applied to all widgets that match "*emacs-menuitem*".  The widgets are
-named by the way they are contained, from the outer widget to the inner widget.
-So to apply the style "my_style" (not shown) with the full, absolute name, for
-the menubar and the scroll bar in Emacs we use:
-
address@hidden
-widget "Emacs.pane.menubar" style "my_style"
-widget "Emacs.pane.emacs.verticalScrollBar" style "my_style"
address@hidden smallexample
- 
-But to avoid having to type it all, wildcards are often used.  @samp{*}
-matches zero or more characters and @samp{?} matches one character.  So "*"
-matches all widgets.
-
-  Each widget has a class (for example GtkMenuItem) and a name 
(emacs-menuitem).
-You can assign styles by name or by class.  In this example we have used the
-class:
-
address@hidden
-style "menufont"
address@hidden
-  font_name = "helvetica bold 14"
address@hidden
-
-widget_class "*GtkMenuBar" style "menufont"
address@hidden smallexample
-
address@hidden
-The names and classes for the GTK widgets Emacs uses are:
-
address@hidden address@hidden plus}} address@hidden and some}
address@hidden @code{emacs-filedialog}
address@hidden @code{GtkFileSelection}
address@hidden @code{emacs-dialog}
address@hidden @code{GtkDialog}
address@hidden @code{Emacs}
address@hidden @code{GtkWindow}
address@hidden @code{pane}
address@hidden @code{GtkVHbox}
address@hidden @code{emacs}
address@hidden @code{GtkFixed}
address@hidden @code{verticalScrollBar}
address@hidden @code{GtkVScrollbar}
address@hidden @code{emacs-toolbar}
address@hidden @code{GtkToolbar}
address@hidden @code{menubar}
address@hidden @code{GtkMenuBar}
address@hidden @code{emacs-menuitem}
address@hidden anything in menus
address@hidden multitable
-
-  GTK absolute names are quite strange when it comes to menus
-and dialogs.  The names do not start with @samp{Emacs}, as they are
-free-standing windows and not contained (in the GTK sense) by the
-Emacs GtkWindow.  To customize the dialogs and menus, use wildcards like this:
-
address@hidden
-widget "*emacs-dialog*" style "my_dialog_style"
-widget "*emacs-filedialog* style "my_file_style"
-widget "*emacs-menuitem* style "my_menu_style"
address@hidden smallexample
-
-  If you specify a customization in @file{~/.emacs.d/gtkrc}, then it
-automatically applies only to Emacs, since other programs don't read
-that file.  For example, the drop down menu in the file dialog can not
-be customized by any absolute widget name, only by an absolute class
-name.  This is because the widgets in the drop down menu do not
-have names and the menu is not contained in the Emacs GtkWindow.  To
-have all menus in Emacs look the same, use this in
address@hidden/.emacs.d/gtkrc}:
-
address@hidden
-widget_class "*Menu*" style "my_menu_style"
address@hidden smallexample
-
-  Here is a more elaborate example, showing how to change the parts of
-the scroll bar:
-
address@hidden
-style "scroll"
address@hidden
-  fg[NORMAL] = "red"@ @ @ @ @ # @r{The arrow color.}
-  bg[NORMAL] = "yellow"@ @ # @r{The thumb and background around the arrow.}
-  bg[ACTIVE] = "blue"@ @ @ @ # @r{The trough color.}
-  bg[PRELIGHT] = "white"@ # @r{The thumb color when the mouse is over it.}
address@hidden
-
-widget "*verticalScrollBar*" style "scroll"
address@hidden smallexample
-
address@hidden
-   arch-tag: e1856f29-2482-42c0-a990-233cdccd1f21
address@hidden ignore