104 |
To see what faces are currently defined, and what they look like, |
To see what faces are currently defined, and what they look like, |
105 |
type @kbd{M-x list-faces-display}. It's possible for a given face to |
type @kbd{M-x list-faces-display}. It's possible for a given face to |
106 |
look different in different frames; this command shows the appearance |
look different in different frames; this command shows the appearance |
107 |
in the frame in which you type it. Here are the standard faces |
in the frame in which you type it. |
108 |
for specifying text appearance: |
|
109 |
|
Here are the standard faces for specifying text appearance. You can |
110 |
|
use them on specific text, when you want the effects they produce. |
111 |
|
|
112 |
@table @code |
@table @code |
113 |
@item default |
@item default |
114 |
This face is used for ordinary text that doesn't specify any other face. |
This face is used for ordinary text that doesn't specify any other face. |
115 |
@item bold |
@item bold |
116 |
This face uses a bold variant of the default font, if it has one. |
This face uses a bold variant of the default font, if it has one. |
117 |
|
It's up to you to choose a default font that has a bold variant, |
118 |
|
if you want to use one. |
119 |
@item italic |
@item italic |
120 |
This face uses an italic variant of the default font, if it has one. |
This face uses an italic variant of the default font, if it has one. |
121 |
@item bold-italic |
@item bold-italic |
123 |
@item underline |
@item underline |
124 |
This face underlines text. |
This face underlines text. |
125 |
@item fixed-pitch |
@item fixed-pitch |
126 |
The basic fixed-pitch face. |
This face forces use of a particular fixed-width font. |
127 |
@item variable-pitch |
@item variable-pitch |
128 |
The basic variable-pitch face. |
This face forces use of a particular variable-width font. It's |
129 |
|
reasonable to customize this to use a different variable-width font, |
130 |
|
if you like, but you should not make it a fixed-width font. |
131 |
|
@item shadow |
132 |
|
This face is used for making the text less noticeable than the surrounding |
133 |
|
ordinary text. Usually this can be achieved by using shades of gray in |
134 |
|
contrast with either black or white default foreground color. |
135 |
@end table |
@end table |
136 |
|
|
137 |
Here's an incomplete list of faces used to highlight parts of the |
Here's an incomplete list of faces used to highlight parts of the |
156 |
This face is used for displaying a secondary X selection (@pxref{Secondary |
This face is used for displaying a secondary X selection (@pxref{Secondary |
157 |
Selection}). |
Selection}). |
158 |
@item trailing-whitespace |
@item trailing-whitespace |
159 |
The face for highlighting trailing whitespace when |
The face for highlighting excess spaces and tabs at the end of a line |
160 |
@code{show-trailing-whitespace} is non-@code{nil}; see @ref{Useless |
when @code{show-trailing-whitespace} is non-@code{nil}; see |
161 |
Whitespace}. |
@ref{Useless Whitespace}. |
162 |
@item nobreak-space |
@item nobreak-space |
163 |
The face for displaying the character ``nobreak space''. |
The face for displaying the character ``nobreak space''. |
164 |
@item escape-glyph |
@item escape-glyph |
165 |
The face for highlighting the @samp{\} or @samp{^} that indicates |
The face for highlighting the @samp{\} or @samp{^} that indicates |
166 |
a control character. It's also used when @samp{\} indicates a |
a control character. It's also used when @samp{\} indicates a |
167 |
nobreak space or nobreak (soft) hyphen. |
nobreak space or nobreak (soft) hyphen. |
|
@item shadow |
|
|
The basic face for making the text less noticeable than the surrounding |
|
|
ordinary text. Usually this is achieved by using shades of grey in |
|
|
contrast with either black or white default foreground color. |
|
168 |
@end table |
@end table |
169 |
|
|
170 |
@cindex @code{region} face |
@cindex @code{region} face |
181 |
|
|
182 |
@table @code |
@table @code |
183 |
@item mode-line |
@item mode-line |
184 |
This face is used for the mode line of the currently selected window. |
@itemx modeline |
185 |
By default, it's drawn with shadows for a ``raised'' effect on window |
This face is used for the mode line of the currently selected window, |
186 |
systems, and drawn as the inverse of the default face on non-windowed |
and for menu bars when toolkit menus are not used. By default, it's |
187 |
terminals. |
drawn with shadows for a ``raised'' effect on window systems, and |
188 |
|
drawn as the inverse of the default face on non-windowed terminals. |
189 |
|
@code{modeline} is an alias for the @code{mode-line} face, for |
190 |
|
compatibility with old Emacs versions. |
191 |
@item mode-line-inactive |
@item mode-line-inactive |
192 |
Like @code{mode-line}, but used for mode lines of the windows other |
Like @code{mode-line}, but used for mode lines of the windows other |
193 |
than the selected one (if @code{mode-line-in-non-selected-windows} is |
than the selected one (if @code{mode-line-in-non-selected-windows} is |
195 |
in that face affect mode lines in all windows. |
in that face affect mode lines in all windows. |
196 |
@item header-line |
@item header-line |
197 |
Similar to @code{mode-line} for a window's header line. Most modes |
Similar to @code{mode-line} for a window's header line. Most modes |
198 |
don't use the header line, but the Info mode does. |
don't use the header line, but some special modes, such the Info mode, do. |
199 |
@item vertical-border |
@item vertical-border |
200 |
This face is used for the vertical divider between windows. |
This face is used for the vertical divider between windows. |
201 |
By default this face inherits from the @code{mode-line-inactive} face |
By default this face inherits from the @code{mode-line-inactive} face |
203 |
this face is used for the vertical line between windows without |
this face is used for the vertical line between windows without |
204 |
scrollbars. |
scrollbars. |
205 |
@item minibuffer-prompt |
@item minibuffer-prompt |
206 |
|
@cindex @code{minibuffer-prompt} face |
207 |
|
@vindex minibuffer-prompt-properties |
208 |
This face is used for the prompt strings displayed in the minibuffer. |
This face is used for the prompt strings displayed in the minibuffer. |
209 |
|
By default, Emacs automatically adds this face to the value of |
210 |
|
@code{minibuffer-prompt-properties}, which is a list of text |
211 |
|
properties used to display the prompt text. |
212 |
@item fringe |
@item fringe |
213 |
@cindex fringe |
@cindex @code{fringe} face |
214 |
The face for the fringes to the left and right of windows on graphic |
The face for the fringes to the left and right of windows on graphic |
215 |
displays. (The fringes are the narrow portions of the Emacs frame |
displays. (The fringes are the narrow portions of the Emacs frame |
216 |
between the text area and the window's right and left borders.) |
between the text area and the window's right and left borders.) |