Mercurial > hg > xemacs-beta

comparison man/xemacs/custom.texi @ 1142:55834f418dfb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[xemacs-hg @ 2002-12-04 14:00:37 by stephent] frob-face <87wumplwf7.fsf@tleepslib.sk.tsukuba.ac.jp>
author stephent
date Wed, 04 Dec 2002 14:00:46 +0000
parents c6facab13185
children f43f9ca6c7d9
comparison
equal deleted inserted replaced
1141:0dade3314f4f 1142:55834f418dfb
501 Each face attribute has its own line. The @samp{[@var{x}]} field 501 Each face attribute has its own line. The @samp{[@var{x}]} field
502 before the attribute name indicates whether the attribute is 502 before the attribute name indicates whether the attribute is
503 @dfn{enabled}; @samp{X} means that it is. You can enable or disable the 503 @dfn{enabled}; @samp{X} means that it is. You can enable or disable the
504 attribute by invoking that field. When the attribute is enabled, you 504 attribute by invoking that field. When the attribute is enabled, you
505 can change the attribute value in the usual ways. 505 can change the attribute value in the usual ways.
506
507 @xref{Faces}, for description of how @code{face-frob-from-locale-first}
508 variable affects changing @samp{Bold} and @samp{Italic} attributes.
506 509
507 @c Is this true for XEmacs? 510 @c Is this true for XEmacs?
508 @c On a black-and-white display, the colors you can use for the 511 @c On a black-and-white display, the colors you can use for the
509 @c background are @samp{black}, @samp{white}, @samp{gray}, @samp{gray1}, 512 @c background are @samp{black}, @samp{white}, @samp{gray}, @samp{gray1},
510 @c and @samp{gray3}. Emacs supports these shades of gray by using 513 @c and @samp{gray3}. Emacs supports these shades of gray by using
2031 Change the foreground color of the given @var{face}. 2034 Change the foreground color of the given @var{face}.
2032 @item M-x set-face-underline-p 2035 @item M-x set-face-underline-p
2033 Change whether the given @var{face} is underlined. 2036 Change whether the given @var{face} is underlined.
2034 @end table 2037 @end table
2035 2038
2036 @findex make-face-bold
2037 @findex make-face-bold-italic
2038 @findex make-face-italic
2039 @findex make-face-unbold
2040 @findex make-face-unitalic
2041 @findex make-face-larger 2039 @findex make-face-larger
2042 @findex make-face-smaller 2040 @findex make-face-smaller
2043 2041
2044 @findex invert-face 2042 @findex invert-face
2045 You can exchange the foreground and background color of the selected 2043 You can exchange the foreground and background color of the selected
2047 specify both foreground and background, then its foreground and 2045 specify both foreground and background, then its foreground and
2048 background are set to the background and foreground of the default face. 2046 background are set to the background and foreground of the default face.
2049 When calling this from a program, you can supply the optional argument 2047 When calling this from a program, you can supply the optional argument
2050 @var{frame} to specify which frame is affected; otherwise, all frames 2048 @var{frame} to specify which frame is affected; otherwise, all frames
2051 are affected. 2049 are affected.
2050
2051 @findex make-face-bold
2052 @findex make-face-bold-italic
2053 @findex make-face-italic
2054 @findex make-face-unbold
2055 @findex make-face-unitalic
2056 @vindex face-frob-from-locale-first
2057 The work of @code{make-face-bold}, @code{make-face-bold-italic},
2058 @code{make-face-italic}, @code{make-face-unbold},
2059 @code{make-face-unitalic} functions is affected by
2060 @code{face-frob-from-locale-first} variable. If it is @code{nil}, those
2061 functions first try to manipulate device specific data like X font names
2062 to obtain the desired font face specification. This may be unsuitable
2063 in environments using different font face specifications for different
2064 frames, non-Mule environments in particular.
2065
2066 If the variable is non-@code{nil}, those functions first try to figure
2067 out whether the face font is the same as one of predefined faces:
2068 @code{default}, @code{bold}, @code{italic}, @code{bold-italic}. If it
2069 is the same, then the new face font specification is set to be the same
2070 as that of a corresponding predefined face. Thus if the predefined face
2071 is set up properly for different frames, the same will hold for the face
2072 being changed by the functions. This is the behavior one might desire
2073 in non-Mule environments mentioned above: face being changed still looks
2074 right in all frames.
2075
2076 How predefined faces might be set up for different frames in such an
2077 environments is described in @ref{Face Resources}.
2052 2078
2053 @findex set-face-background 2079 @findex set-face-background
2054 You can set the background color of the specified @var{face} with the 2080 You can set the background color of the specified @var{face} with the
2055 function @code{set-face-background}. The argument @code{color} should 2081 function @code{set-face-background}. The argument @code{color} should
2056 be a string, the name of a color. When called from a program, if the 2082 be a string, the name of a color. When called from a program, if the