update.

[chise/xemacs-chise.git.1] / man / xemacs / custom.texi

diff --git a/man/xemacs/custom.texi b/man/xemacs/custom.texi
index 5be3610..5aeef5d 100644 (file)
--- a/man/xemacs/custom.texi
+++ b/man/xemacs/custom.texi
@@ -179,7 +179,8 @@ except where explicitly stated, affects only the current Emacs session.
 @findex customize
 @cindex customization buffer
   A convenient way to find the user option variables that you want to
 @findex customize
 @cindex customization buffer
   A convenient way to find the user option variables that you want to

-change, and then change them, is with @kbd{M-x customize}.  This command
+change, and then change them, is with @kbd{M-x customize} (or use a
+keyboard shortcut, @kbd{C-h C}.  This command

 creates a @dfn{customization buffer} with which you can browse through
 the Emacs user options in a logically organized structure, then edit and
 set their values.  You can also use the customization buffer to save
 creates a @dfn{customization buffer} with which you can browse through
 the Emacs user options in a logically organized structure, then edit and
 set their values.  You can also use the customization buffer to save

@@ -203,8 +204,8 @@ structure as of yet, but we are adding the rest.)
 @dfn{groups} to help you find them.  Groups are collected into bigger
 groups, all the way up to a master group called @code{Emacs}.
 
 @dfn{groups} to help you find them.  Groups are collected into bigger
 groups, all the way up to a master group called @code{Emacs}.
 

-  @kbd{M-x customize} creates a customization buffer that shows the
-top-level @code{Emacs} group and the second-level groups immediately
+  @kbd{M-x customize} (or @kbd{C-h C}) creates a customization buffer that
+shows the top-level @code{Emacs} group and the second-level groups immediately

 under it.  It looks like this, in part:
 
 @smallexample
 under it.  It looks like this, in part:
 
 @smallexample

@@ -464,6 +465,9 @@ before the attribute name indicates whether the attribute is
 attribute by invoking that field.  When the attribute is enabled, you
 can change the attribute value in the usual ways.
 
 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},
 @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},

@@ -1026,7 +1030,7 @@ just like @key{RET}.  This is used mainly for Mocklisp compatibility.
 @code{minibuffer-local-must-match-map} is for strict completion and
 for cautious completion.
 @item
 @code{minibuffer-local-must-match-map} is for strict completion and
 for cautious completion.
 @item

-@code{repeat-complex-command-map} is for use in @kbd{C-x @key{ESC}}.
+@code{repeat-complex-command-map} is for use in @kbd{C-x @key{ESC} @key{ESC}}.

 @item
 @code{isearch-mode-map} contains the bindings of the special keys which
 are bound in the pseudo-mode entered with @kbd{C-s} and @kbd{C-r}.
 @item
 @code{isearch-mode-map} contains the bindings of the special keys which
 are bound in the pseudo-mode entered with @kbd{C-s} and @kbd{C-r}.

@@ -1415,8 +1419,9 @@ is used to specify the syntactic class of opening delimiters.  Here is a
 table of syntactic classes, with the characters that specify them.
 
 @table @samp
 table of syntactic classes, with the characters that specify them.
 
 @table @samp

-@item @w{ }
-The class of whitespace characters.
+@item @w{-}
+The class of whitespace characters.  Please don't use the formerly
+advertised @w{ }, which is not supported by GNU Emacs.

 @item w
 The class of word-constituent characters.
 @item _
 @item w
 The class of word-constituent characters.
 @item _

@@ -1990,11 +1995,6 @@ Change the foreground color of the given @var{face}.
 Change whether the given @var{face} is underlined.
 @end table
 
 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
 
 @findex make-face-larger
 @findex make-face-smaller
 

@@ -2007,6 +2007,34 @@ 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.
 
 @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
 @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

@@ -2078,7 +2106,7 @@ run both variants.
 Starting with XEmacs 21, XEmacs uses the class @samp{XEmacs} if it finds
 any XEmacs resources in the resource database when the X connection is
 initialized.  Otherwise, it will use the class @samp{Emacs} for
 Starting with XEmacs 21, XEmacs uses the class @samp{XEmacs} if it finds
 any XEmacs resources in the resource database when the X connection is
 initialized.  Otherwise, it will use the class @samp{Emacs} for

-backwards compatibility.  The variable @var{x-emacs-application-class}
+backwards compatibility.  The variable @code{x-emacs-application-class}

 may be consulted to determine the application class being used.
 
 The examples in this section assume the application class is @samp{Emacs}.
 may be consulted to determine the application class being used.
 
 The examples in this section assume the application class is @samp{Emacs}.