[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/display.texi
From: |
Juri Linkov |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/display.texi |
Date: |
Mon, 22 Aug 2005 17:31:54 -0400 |
Index: emacs/lispref/display.texi
diff -c emacs/lispref/display.texi:1.181 emacs/lispref/display.texi:1.182
*** emacs/lispref/display.texi:1.181 Mon Aug 22 21:06:31 2005
--- emacs/lispref/display.texi Mon Aug 22 21:31:54 2005
***************
*** 1673,1679 ****
A @dfn{face} is a named collection of graphical attributes: font
family, foreground color, background color, optional underlining, and
many others. Faces are used in Emacs to control the style of display of
! particular parts of the text or the frame.
@cindex face id
Each face has its own @dfn{face number}, which distinguishes faces at
--- 1673,1681 ----
A @dfn{face} is a named collection of graphical attributes: font
family, foreground color, background color, optional underlining, and
many others. Faces are used in Emacs to control the style of display of
! particular parts of the text or the frame. @xref{Standard Faces,,,
! emacs, The GNU Emacs Manual}, for the list of faces Emacs normally
! comes with.
@cindex face id
Each face has its own @dfn{face number}, which distinguishes faces at
***************
*** 1691,1697 ****
face name a special meaning in one frame if you wish.
@menu
- * Standard Faces:: The faces Emacs normally comes with.
* Defining Faces:: How to define a face with @code{defface}.
* Face Attributes:: What is in a face?
* Attribute Functions:: Functions to examine and set face attributes.
--- 1693,1698 ----
***************
*** 1705,1843 ****
that handle a range of character sets.
@end menu
- @node Standard Faces
- @subsection Standard Faces
-
- This table lists all the standard faces and their uses. Most of them
- are used for displaying certain parts of the frames or certain kinds of
- text; you can control how those places look by customizing these faces.
-
- @table @code
- @item default
- @kindex default @r{(face name)}
- This face is used for ordinary text.
-
- @item mode-line
- @kindex mode-line @r{(face name)}
- This face is used for the mode line of the selected window, and for
- menu bars when toolkit menus are not used.
-
- @item modeline
- @kindex modeline @r{(face name)}
- This is an alias for the @code{mode-line} face, for compatibility with
- old Emacs versions.
-
- @item mode-line-inactive
- @kindex mode-line-inactive @r{(face name)}
- This face is used for mode lines of non-selected windows.
- This face inherits from @code{mode-line}, so changes
- in that face affect all windows.
-
- @item header-line
- @kindex header-line @r{(face name)}
- This face is used for the header lines of windows that have them.
-
- @item menu
- This face controls the display of menus, both their colors and their
- font. (This works only on certain systems.)
-
- @item fringe
- @kindex fringe @r{(face name)}
- This face controls the default colors of window fringes, the thin
- areas on either side that are used to display continuation and
- truncation glyphs. Other faces used to display bitmaps in the fringe
- are implicitly merged with this face.
-
- @item minibuffer-prompt
- @kindex minibuffer-prompt @r{(face name)}
- @vindex minibuffer-prompt-properties
- This face is used for the text of minibuffer prompts. By default,
- Emacs automatically adds this face to the value of
- @code{minibuffer-prompt-properties}, which is a list of text
- properties used to display the prompt text.
-
- @item scroll-bar
- @kindex scroll-bar @r{(face name)}
- This face controls the colors for display of scroll bars.
-
- @item tool-bar
- @kindex tool-bar @r{(face name)}
- This face is used for display of the tool bar, if any.
-
- @item region
- @kindex region @r{(face name)}
- This face is used for highlighting the region in Transient Mark mode.
-
- @item secondary-selection
- @kindex secondary-selection @r{(face name)}
- This face is used to show any secondary selection you have made.
-
- @item highlight
- @kindex highlight @r{(face name)}
- This face is meant to be used for highlighting for various purposes.
-
- @item mode-line-highlight
- @kindex mode-line-highlight @r{(face name)}
- This face is used for highlighting something on @code{mode-line} or
- @code{header-line} for various purposes.
-
- @item trailing-whitespace
- @kindex trailing-whitespace @r{(face name)}
- This face is used to display excess whitespace at the end of a line,
- if @code{show-trailing-whitespace} is address@hidden
-
- @item escape-glyph
- @kindex escape-glyph @r{(face name)}
- This face is used to display control characters and escape glyphs.
- @end table
-
- In contrast, these faces are provided to change the appearance of text
- in specific ways. You can use them on specific text, when you want
- the effects they produce.
-
- @table @code
- @item bold
- @kindex bold @r{(face name)}
- This face uses a bold font, if possible. It uses the bold variant of
- the frame's font, if it has one. It's up to you to choose a default
- font that has a bold variant, if you want to use one.
-
- @item italic
- @kindex italic @r{(face name)}
- This face uses the italic variant of the frame's font, if it has one.
-
- @item bold-italic
- @kindex bold-italic @r{(face name)}
- This face uses the bold italic variant of the frame's font, if it has
- one.
-
- @item underline
- @kindex underline @r{(face name)}
- This face underlines text.
-
- @item fixed-pitch
- @kindex fixed-pitch @r{(face name)}
- This face forces use of a particular fixed-width font.
-
- @item variable-pitch
- @kindex variable-pitch @r{(face name)}
- This face forces use of a particular variable-width font. It's
- reasonable to customize this to use a different variable-width font, if
- you like, but you should not make it a fixed-width font.
-
- @item shadow
- @kindex shadow @r{(face name)}
- This face is used for making the text less noticeable than the
- surrounding ordinary text.
- @end table
-
- @defvar show-trailing-whitespace
- @tindex show-trailing-whitespace
- If this variable is address@hidden, Emacs uses the
- @code{trailing-whitespace} face to display any spaces and tabs at the
- end of a line.
- @end defvar
-
@node Defining Faces
@subsection Defining Faces
--- 1706,1711 ----
***************
*** 2382,2388 ****
@item
With a region that is active. In Transient Mark mode, the region is
! highlighted with the face @code{region} (@pxref{Standard Faces}).
@item
With special glyphs. Each glyph can specify a particular face
--- 2250,2257 ----
@item
With a region that is active. In Transient Mark mode, the region is
! highlighted with the face @code{region} (@pxref{Standard Faces,,,
! emacs, The GNU Emacs Manual}).
@item
With special glyphs. Each glyph can specify a particular face
- [Emacs-diffs] Changes to emacs/lispref/display.texi, Richard M . Stallman, 2005/08/09
- [Emacs-diffs] Changes to emacs/lispref/display.texi, Richard M . Stallman, 2005/08/09
- [Emacs-diffs] Changes to emacs/lispref/display.texi, Thien-Thi Nguyen, 2005/08/11
- [Emacs-diffs] Changes to emacs/lispref/display.texi, Richard M . Stallman, 2005/08/11
- [Emacs-diffs] Changes to emacs/lispref/display.texi, Juri Linkov, 2005/08/22
- [Emacs-diffs] Changes to emacs/lispref/display.texi,
Juri Linkov <=
- [Emacs-diffs] Changes to emacs/lispref/display.texi, Richard M . Stallman, 2005/08/25