--- a/man/xemacs/custom.texi	Mon Dec 02 22:53:28 2002 +0000
+++ b/man/xemacs/custom.texi	Tue Dec 03 10:35:17 2002 +0000
@@ -492,9 +492,9 @@
             [ ] Foreground: white       (sample)
             [ ] Background: blue        (sample)
             [ ] Inverse: [Toggle]  off (nil)
-            [ ] Stipple: 
-            [ ] Font Family: 
-            [ ] Size: 
+            [ ] Stipple:
+            [ ] Font Family:
+            [ ] Size:
             [ ] Strikethru: off
 @end smallexample
 
@@ -509,7 +509,7 @@
 @c background are @samp{black}, @samp{white}, @samp{gray}, @samp{gray1},
 @c and @samp{gray3}.  Emacs supports these shades of gray by using
 @c background stipple patterns instead of a color.
-@c 
+@c
   Setting, saving and resetting a face work like the same operations for
 options (@pxref{Changing an Option}).
 
@@ -545,7 +545,7 @@
 @item M-x customize-apropos @key{RET} @var{regexp} @key{RET}
 Set up a customization buffer with all the options, faces and groups
 that match @var{regexp}.
-@item M-x customize-saved 
+@item M-x customize-saved
 Set up a customization buffer containing all options and faces that you
 have saved with customization buffers.
 @item M-x customize-customized
@@ -776,7 +776,7 @@
 enough like Lisp for Lisp mode to be useful but in which comments
 start and end differently.  The prefix and suffix are used in the local
 variables list to make the list look like several lines of comments when
-the compiler or interpreter for that language reads the file. 
+the compiler or interpreter for that language reads the file.
 
   The start of the local variables list must be no more than 3000
 characters from the end of the file, and must be in the last page if the
@@ -888,7 +888,7 @@
 executed, but also becomes part of the definition of the macro.  @samp{Def}
 appears in the mode line to remind you of what is going on.  When you are
 finished, the @kbd{C-x )} command (@code{end-kbd-macro}) terminates the
-definition, without becoming part of it. 
+definition, without becoming part of it.
 
   For example,
 
@@ -1134,9 +1134,9 @@
 local map, which affects all buffers using the same major mode.
 
 @menu
-* Interactive Rebinding::      Changing Key Bindings Interactively   
+* Interactive Rebinding::      Changing Key Bindings Interactively
 * Programmatic Rebinding::     Changing Key Bindings Programmatically
-* Key Bindings Using Strings:: Using Strings for Changing Key Bindings 
+* Key Bindings Using Strings:: Using Strings for Changing Key Bindings
 @end menu
 
 @node Interactive Rebinding
@@ -1148,7 +1148,7 @@
 @table @kbd
 @item M-x global-set-key @key{RET} @var{key} @var{cmd} @key{RET}
 Defines @var{key} globally to run @var{cmd}.
-@item M-x local-set-key @key{RET} @var{keys} @var{cmd} @key{RET} 
+@item M-x local-set-key @key{RET} @var{keys} @var{cmd} @key{RET}
 Defines @var{key} locally (in the major mode now in effect) to run
 @var{cmd}.
 @item M-x local-unset-key @key{RET} @var{keys} @key{RET}
@@ -1217,7 +1217,7 @@
 @item @code{(define-key @var{keymap} @var{keys} @var{def})}
 Defines @var{keys} to run @var{def} in the keymap @var{keymap}.
 @end table
- 
+
 @var{keymap} is a keymap object.
 
 @var{keys} is the sequence of keystrokes to bind.
@@ -1251,7 +1251,7 @@
 @xref{Keystrokes}, for more information about the rules for constructing
 key sequences.
 
-Emacs allows you to abbreviate representations for key sequences in 
+Emacs allows you to abbreviate representations for key sequences in
 most places where there is no ambiguity.
 Here are some rules for abbreviation:
 
@@ -1273,13 +1273,13 @@
 @example
 
 ;;;  Bind @code{my-command} to @key{f1}
-(global-set-key 'f1 'my-command)                
+(global-set-key 'f1 'my-command)
 
 ;;;  Bind @code{my-command} to @kbd{Shift-f1}
 (global-set-key '(shift f1) 'my-command)
 
 ;;; Bind @code{my-command} to @kbd{C-c Shift-f1}
-(global-set-key '[(control c) (shift f1)] 'my-command)  
+(global-set-key '[(control c) (shift f1)] 'my-command)
 
 ;;; Bind @code{my-command} to the middle mouse button.
 (global-set-key 'button2 'my-command)
@@ -1296,13 +1296,13 @@
 @comment (global-set-key '(meta control backspace) 'my-command)
 @comment (global-set-key '(meta control h) 'my-command)
 @comment (global-set-key '(meta control H) 'my-command)
-@comment 
+@comment
 @comment ;; note that this binds two key sequences: ``control-j'' and ``linefeed''.
 @comment ;;
 @comment (global-set-key "\^J" 'my-command)
 
 @node Key Bindings Using Strings
-@subsubsection Using Strings for Changing Key Bindings 
+@subsubsection Using Strings for Changing Key Bindings
 
   For backward compatibility, you can still use strings to represent
 key sequences.  Thus you can use commands like the following:
@@ -1313,7 +1313,7 @@
 @end example
 
 Note, however, that in some cases you may be binding more than one
-key sequence by using a single command.  This situation can 
+key sequence by using a single command.  This situation can
 arise because in ASCII, @kbd{C-i} and @key{TAB} have
 the same representation.  Therefore, when Emacs sees:
 
@@ -1347,11 +1347,11 @@
 similar fashion:
 
 @example
-        control h      backspace           
+        control h      backspace
         control l      clear
-        control i      tab 
-        control m      return              
-        control j      linefeed 
+        control i      tab
+        control m      return
+        control j      linefeed
         control [      escape
         control @@      control space
 @end example
@@ -1883,7 +1883,7 @@
 standard beep.  This only works if you are logged in on the console of a
 machine with audio hardware. To listen to a sound of the provided type,
 call the function @code{play-sound} with the argument @var{sound}. You
-can also set the volume of the sound with the optional argument 
+can also set the volume of the sound with the optional argument
 @var{volume}.@refill
 @cindex ding
 
@@ -1893,7 +1893,7 @@
 
 @table @code
 @item sound
-A string of raw sound data, or the name of another sound to play.   
+A string of raw sound data, or the name of another sound to play.
 The symbol @code{t} here means use the default X beep.
 
 @item volume
@@ -1930,7 +1930,7 @@
 This variable applies to the standard X bell sound as well as sound files.
 
 If the symbol @code{t} is in place of a sound-string, Emacs uses the
-default X beep.  This allows you to define beep-types of 
+default X beep.  This allows you to define beep-types of
 different volumes even when not running on the console.
 
 @findex load-sound-file
@@ -1970,7 +1970,7 @@
 @item y-or-n-p
 You type something other than the required @code{y} or @code{n}
 
-@item yes-or-no-p       
+@item yes-or-no-p
 You type something other than @code{yes} or @code{no}
 @end table
 
@@ -2002,13 +2002,13 @@
 Make the font of the given @var{face} bold.  When called from a
 program, returns @code{nil} if this is not possible.
 @item M-x make-face-bold-italic
-Make the font of the given @var{face} bold italic.  
+Make the font of the given @var{face} bold italic.
 When called from a program, returns @code{nil} if not possible.
 @item M-x make-face-italic
-Make the font of the given @var{face} italic.  
+Make the font of the given @var{face} italic.
 When called from a program, returns @code{nil} if not possible.
 @item M-x make-face-unbold
-Make the font of the given @var{face} non-bold.  
+Make the font of the given @var{face} non-bold.
 When called from a program, returns @code{nil} if not possible.
 @item M-x make-face-unitalic
 Make the font of the given @var{face} non-italic.
@@ -2019,11 +2019,13 @@
 @item M-x make-face-smaller
 Make the font of the given @var{face} a little smaller.
 When called from a program, returns @code{nil} if not possible.
-@item M-x set-face-background 
+@item M-x set-face-background
 Change the background color of the given @var{face}.
 @item M-x set-face-background-pixmap
 Change the background pixmap of the given @var{face}.
-@item M-x set-face-font 
+@item M-x set-face-background-pixmap-file
+A simpler version but with filename completion.
+@item M-x set-face-font
 Change the font of the given @var{face}.
 @item M-x set-face-foreground
 Change the foreground color of the given @var{face}.
@@ -2044,7 +2046,7 @@
 @var{face} with the function @code{invert-face}. If the face does not
 specify both foreground and background, then its foreground and
 background are set to the background and foreground of the default face.
-When calling this from a program, you can supply the optional argument 
+When calling this from a program, you can supply the optional argument
 @var{frame} to specify which frame is affected; otherwise, all frames
 are affected.
 
@@ -2052,7 +2054,7 @@
 You can set the background color of the specified @var{face} with the
 function @code{set-face-background}.  The argument @code{color} should
 be a string, the name of a color.  When called from a program, if the
-optional @var{frame} argument is provided, the face is changed only 
+optional @var{frame} argument is provided, the face is changed only
 in that frame; otherwise, it is changed in all frames.
 
 @findex set-face-background-pixmap
@@ -2074,14 +2076,21 @@
 If the environment variable @b{XBMLANGPATH} is set, then it is consulted
 before the @code{x-bitmap-file-path} variable.
 
+@findex set-face-background-pixmap
+Alternately, you can use a simpler version of
+@code{set-face-background-pixmap} called
+@code{set-face-background-pixmap-file}. This function does not give you
+as much control on the pixmap instanciator, but provides filename
+completion.
+
 @findex set-face-font
 You can set the font of the specified @var{face} with the function
 @code{set-face-font}.  The @var{font} argument should be a string, the
 name of a font.  When called from a program, if the
-optional @var{frame} argument is provided, the face is changed only 
+optional @var{frame} argument is provided, the face is changed only
 in that frame; otherwise, it is changed in all frames.
 
-@findex set-face-foreground 
+@findex set-face-foreground
 You can set the foreground color of the specified @var{face} with the
 function @code{set-face-foreground}.  The argument @var{color} should be
 a string, the name of a color.  If the optional @var{frame} argument is
@@ -2124,8 +2133,8 @@
 
 The examples in this section assume the application class is @samp{Emacs}.
 
-The Emacs resources are generally set per-frame. Each Emacs frame can have 
-its own name or the same name as another, depending on the name passed to the 
+The Emacs resources are generally set per-frame. Each Emacs frame can have
+its own name or the same name as another, depending on the name passed to the
 @code{make-frame} function.
 
 You can specify resources for all frames with the syntax:
@@ -2230,7 +2239,7 @@
 from the geometry of the frame.
 
 @item
-For subsequent frames, the position is taken only from the frame, and 
+For subsequent frames, the position is taken only from the frame, and
 never from the ApplicationShell.
 @end itemize
 
@@ -2261,7 +2270,7 @@
 Whether this frame should appear in the iconified state.
 
 @item @code{internalBorderWidth} (class @code{InternalBorderWidth}): int
-How many blank pixels to leave between the text and the edge of the 
+How many blank pixels to leave between the text and the edge of the
 window.
 
 @item @code{interline} (class @code{Interline}): int
@@ -2459,7 +2468,7 @@
 
 @item zmacs-region
 This is the face that mouse selections are displayed in.
- 
+
 @item isearch
 This is the face that the matched text being searched for is displayed
 in.
@@ -2541,7 +2550,7 @@
 Emacs*menubar*font: *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
 @end example
 
-If both the Lucid Motif-lookalike menu widgets and X Font Sets are 
+If both the Lucid Motif-lookalike menu widgets and X Font Sets are
 configured to allow multilingual menubars, then one uses
 
 @example
@@ -2555,7 +2564,7 @@
 resources (eg, menubars) are ignored in favor of the corresponding
 .fontSet resources.
 
-If the Motif library is being used, then one would have to use 
+If the Motif library is being used, then one would have to use
 
 @example
 Emacs*menubar*fontList: *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
@@ -2564,5 +2573,5 @@
 because the Motif library uses the @code{fontList} resource name instead
 of @code{font}, which has subtly different semantics.
 
-The same is true of the scrollbars: They accept whichever resources are 
+The same is true of the scrollbars: They accept whichever resources are
 appropriate for the toolkit in use.