(quoted-printable-encode-region): Use mm-insert-byte.
[bpt/emacs.git] / man / xresources.texi
index 39aae53..5443063 100644 (file)
@@ -5,11 +5,12 @@
 @appendix 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.  X resources are the
-only way to customize tooltip windows and LessTif menus, since the
-libraries that implement them don't provide for customization through
-Emacs.  This appendix describes the X resources that Emacs recognizes
-and how to use them.
+resources, as is usual for programs that use X.  On MS-Windows, you
+can customize some of the same aspects using the system registry.
+@xref{MS-Windows Registry}.  X resources are the only way to customize
+tooltip windows and LessTif menus, since the libraries that implement
+them don't provide for customization through Emacs.  This appendix
+describes the X resources that Emacs recognizes and how to use them.
 
 @menu
 * Resources::           Using X resources with Emacs (in general).
@@ -19,15 +20,18 @@ and how to use them.
 * LessTif Resources::   X resources for LessTif and Motif menus.
 @end menu
 
-@node Resources X
+@node Resources
 @appendixsec X Resources
 @cindex resources
 
 @cindex X resources, @file{~/.Xdefaults} 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}.
+  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}.  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
@@ -37,8 +41,8 @@ collection of related options, for one program or for several programs
 @cindex @file{.Xdefaults} file, and 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 keys @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs}
-and @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}.
+Registry, under the key @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs}
+and then under the key @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}.
 
   Programs define named resources with particular meanings.  They also
 define how to group resources into named classes.  For instance, in
@@ -137,7 +141,8 @@ Changes take effect immediately if you click on the @samp{Apply} button.
 @appendixsec Table of X Resources for Emacs
 
   This table lists the resource names that designate options for
-Emacs, each with the class that it belongs to:
+Emacs, not counting those for the appearance of the menu bar, each
+with the class that it belongs to:
 
 @table @asis
 @item @code{background} (class @code{Background})
@@ -172,6 +177,15 @@ 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.
 
+@item @code{fullscreen} (class @code{Fullscreen})
+The desired fullscreen size.  The value can be one of @code{fullboth},
+@code{fullwidth} or @code{fullheight}, which correspond to
+the command-line options @samp{-fs}, @samp{-fw}, and @samp{-fh}
+(@pxref{Window Size X}).
+
+Note that this applies to all frames created, not just the initial
+one.
+
 @item @code{iconName} (class @code{Title})
 Name to display in the icon.
 
@@ -184,7 +198,9 @@ Width in pixels of the internal border.
 Additional space (@dfn{leading}) between lines, in pixels.
 
 @item @code{menuBar} (class @code{MenuBar})
-Give frames menu bars if @samp{on}; don't have menu bars if @samp{off}.
+Give frames menu bars if @samp{on}; don't have menu bars if
+@samp{off}.  @xref{Lucid Resources}, and @ref{LessTif Resources}, for
+how to control the appearance of the menu bar if you have one.
 
 @item @code{toolBar} (class @code{ToolBar})
 Number of lines to reserve for the tool bar.  A zero value suppresses