--- a/man/ChangeLog	Wed Dec 04 13:54:45 2002 +0000
+++ b/man/ChangeLog	Wed Dec 04 14:00:46 2002 +0000
@@ -1,3 +1,9 @@
+2002-11-12  Ilya N. Golubev  <gin@mo.msk.ru>
+
+	* xemacs/custom.texi (Face Customization):
+	(Faces):
+	Document face-frob-from-locale-first variable.
+
 2002-12-03  Didier Verna  <didier@xemacs.org>
 
 	* xemacs-faq.texi (Customization): add missing menu entry for Q3.2.7.

--- a/man/xemacs/custom.texi	Wed Dec 04 13:54:45 2002 +0000
+++ b/man/xemacs/custom.texi	Wed Dec 04 14:00:46 2002 +0000
@@ -504,6 +504,9 @@
 attribute by invoking that field.  When the attribute is enabled, you
 can change the attribute value in the usual ways.
 
+@xref{Faces}, for description of how @code{face-frob-from-locale-first}
+variable affects changing @samp{Bold} and @samp{Italic} attributes.
+
 @c Is this true for XEmacs?
 @c  On a black-and-white display, the colors you can use for the
 @c background are @samp{black}, @samp{white}, @samp{gray}, @samp{gray1},
@@ -2033,11 +2036,6 @@
 Change whether the given @var{face} is underlined.
 @end table
 
-@findex make-face-bold
-@findex make-face-bold-italic
-@findex make-face-italic
-@findex make-face-unbold
-@findex make-face-unitalic
 @findex make-face-larger
 @findex make-face-smaller
 
@@ -2050,6 +2048,34 @@
 @var{frame} to specify which frame is affected; otherwise, all frames
 are affected.
 
+@findex make-face-bold
+@findex make-face-bold-italic
+@findex make-face-italic
+@findex make-face-unbold
+@findex make-face-unitalic
+@vindex face-frob-from-locale-first
+The work of @code{make-face-bold}, @code{make-face-bold-italic},
+@code{make-face-italic}, @code{make-face-unbold},
+@code{make-face-unitalic} functions is affected by
+@code{face-frob-from-locale-first} variable.  If it is @code{nil}, those
+functions first try to manipulate device specific data like X font names
+to obtain the desired font face specification.  This may be unsuitable
+in environments using different font face specifications for different
+frames, non-Mule environments in particular.
+
+If the variable is non-@code{nil}, those functions first try to figure
+out whether the face font is the same as one of predefined faces:
+@code{default}, @code{bold}, @code{italic}, @code{bold-italic}.  If it
+is the same, then the new face font specification is set to be the same
+as that of a corresponding predefined face.  Thus if the predefined face
+is set up properly for different frames, the same will hold for the face
+being changed by the functions.  This is the behavior one might desire
+in non-Mule environments mentioned above: face being changed still looks
+right in all frames.
+
+How predefined faces might be set up for different frames in such an
+environments is described in @ref{Face Resources}.
+
 @findex set-face-background
 You can set the background color of the specified @var{face} with the
 function @code{set-face-background}.  The argument @code{color} should