X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=man%2Fxemacs%2Fcustom.texi;h=5aeef5d8322a0763f65ea6af9a9ab3f83940c3de;hb=300ebad446cfb998724e0905fc4d46911b1f1410;hp=71d0aa5c8fab5411b67552b3b2c859699e971858;hpb=762383636a99307282c2d93d26c35c046ec24da1;p=chise%2Fxemacs-chise.git diff --git a/man/xemacs/custom.texi b/man/xemacs/custom.texi index 71d0aa5..5aeef5d 100644 --- 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 -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 @@ -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}. - @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 @@ -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. +@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}, @@ -749,7 +753,7 @@ long file that contains no page markers and has no local variables list. list. That is inappropriate. Whether you use Auto Fill mode or not is a matter of personal taste, not a matter of the contents of particular files. If you want to use Auto Fill, set up major mode hooks with your -file file to turn it on (when appropriate) for you alone +init file to turn it on (when appropriate) for you alone (@pxref{Init File}). Don't try to use a local variable list that would impose your taste on everyone working with the file. @@ -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{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}. @@ -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 -@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 _ @@ -1990,11 +1995,6 @@ Change the foreground color of the given @var{face}. 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 @@ -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. +@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 @@ -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 -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}. @@ -2493,13 +2521,27 @@ proper, it does not use the face mechanism for specifying fonts and colors: It uses whatever resources are appropriate to the type of widget which is used to implement it. -If Emacs was compiled to use only the Motif-lookalike menu widgets, then one -way to specify the font of the menubar would be +If Emacs was compiled to use only the Lucid Motif-lookalike menu widgets, +then one way to specify the font of the menubar would be @example Emacs*menubar*font: *-courier-medium-r-*-*-*-120-*-*-*-*-*-* @end example +If both the Lucid Motif-lookalike menu widgets and X Font Sets are +configured to allow multilingual menubars, then one uses + +@example +*menubar*FontSet: -*-helvetica-bold-r-*-*-*-120-*-*-*-*-iso8859-*, \ + -*-*-*-*-*-*-*-120-*-jisx0208.1983-0 +@end example + +That would specify fonts for a Japanese menubar. Specifying only one +XLFD is acceptable; specifying more than one for a given registry +(language) is also allowed. When X Font Sets are configured, some .font +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 @example