/[emacs]/emacs/man/display.texi
ViewVC logotype

Diff of /emacs/man/display.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.100 by ttn, Wed Aug 10 15:14:30 2005 UTC revision 1.101 by jurta, Mon Aug 22 21:35:07 2005 UTC
# Line 104  future Emacs versions. Line 104  future Emacs versions.
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
# Line 119  This face uses a bold italic variant of Line 123  This face uses a bold italic variant of
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
# Line 146  mode is enabled---see below). Line 156  mode is enabled---see below).
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
# Line 175  appearance of these parts of the frame. Line 181  appearance of these parts of the frame.
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
# Line 186  non-@code{nil}).  This face inherits fro Line 195  non-@code{nil}).  This face inherits fro
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
# Line 194  on character terminals.  On window syste Line 203  on character terminals.  On window syste
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.)

Legend:
Removed from v.1.100  
changed lines
  Added in v.1.101

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26