[Emacs-diffs] emacs-24 r117624: Improve documentation of faces in the user manual.

[Eli Zaretskii]

------------------------------------------------------------
revno: 117624
revision-id: address@hidden
parent: address@hidden
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-24
timestamp: Fri 2014-10-24 12:13:01 +0300
message:
  Improve documentation of faces in the user manual.
  
   doc/emacs/frames.texi (Scroll Bars): Improve indexing of faces.
   doc/emacs/killing.texi (Secondary Selection): Improve indexing of faces.
   doc/emacs/search.texi (Basic Isearch, Query Replace): Improve indexing of
   faces.
   doc/emacs/display.texi (Standard Faces, Text Display)
   (Useless Whitespace): Improve indexing of faces.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/display.texi         
display.texi-20091113204419-o5vbwnq5f7feedwu-6243
  doc/emacs/frames.texi          
frames.texi-20091113204419-o5vbwnq5f7feedwu-6252
  doc/emacs/killing.texi         
killing.texi-20091113204419-o5vbwnq5f7feedwu-6258
  doc/emacs/search.texi          
search.texi-20091113204419-o5vbwnq5f7feedwu-6276

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-10-23 19:17:00 +0000
+++ b/doc/emacs/ChangeLog       2014-10-24 09:13:01 +0000
@@ -1,3 +1,14 @@
+2014-10-24  Eli Zaretskii  <address@hidden>
+
+       * frames.texi (Scroll Bars): Improve indexing of faces.
+
+       * killing.texi (Secondary Selection): Improve indexing of faces.
+
+       * search.texi (Basic Isearch, Query Replace): Improve indexing of faces.
+
+       * display.texi (Standard Faces, Text Display)
+       (Useless Whitespace): Improve indexing of faces.
+
 2014-10-23  Tassilo Horn  <address@hidden>
 
        * misc.texi (Document View): Adapt to latest doc-view changes wrt

=== modified file 'doc/emacs/display.texi'
--- a/doc/emacs/display.texi    2014-10-04 06:35:55 +0000
+++ b/doc/emacs/display.texi    2014-10-24 09:13:01 +0000
@@ -578,6 +578,7 @@
 
 @node Standard Faces
 @section Standard Faces
address@hidden standard faces
 
   Here are the standard faces for specifying text appearance.  You can
 apply them to specific text when you want the effects they produce.
@@ -598,8 +599,10 @@
 This face forces use of a fixed-width font.  It's reasonable to
 customize this face to use a different fixed-width font, if you like,
 but you should not make it a variable-width font.
address@hidden variable-pitch face
 @item variable-pitch
 This face forces use of a variable-width font.
address@hidden shadow face
 @item shadow
 This face is used for making the text less noticeable than the surrounding
 ordinary text.  Usually this can be achieved by using shades of gray in
@@ -647,25 +650,34 @@
 
 @table @code
 @item mode-line
address@hidden mode-line face
address@hidden faces for mode lines
 This face is used for the mode line of the currently selected window,
 and for menu bars when toolkit menus are not used.  By default, it's
 drawn with shadows for a ``raised'' effect on graphical displays, and
 drawn as the inverse of the default face on non-windowed terminals.
 @item mode-line-inactive
address@hidden mode-line-inactive face
 Like @code{mode-line}, but used for mode lines of the windows other
 than the selected one (if @code{mode-line-in-non-selected-windows} is
 address@hidden).  This face inherits from @code{mode-line}, so changes
 in that face affect mode lines in all windows.
 @item mode-line-highlight
-Like @code{highlight}, but used for portions of text on mode lines.
address@hidden mode-line-highlight face
+Like @code{highlight}, but used for mouse-sensitive portions of text
+on mode lines.  Such portions of text typically pop up tooltips
+(@pxref{Tooltips}) when the mouse pointer hovers above them.
 @item mode-line-buffer-id
address@hidden mode-line-buffer-id face
 This face is used for buffer identification parts in the mode line.
 @item header-line
address@hidden header-line face
 Similar to @code{mode-line} for a window's header line, which appears
 at the top of a window just as the mode line appears at the bottom.
 Most windows do not have a header line---only some special modes, such
 Info mode, create one.
 @item vertical-border
address@hidden vertical-border face
 This face is used for the vertical divider between windows on text
 terminals.
 @item minibuffer-prompt
@@ -1110,6 +1122,7 @@
 cases, this @dfn{trailing whitespace} has no effect, but sometimes it
 can be a nuisance.
 
address@hidden trailing-whitespace face
   You can make trailing whitespace at the end of a line visible by
 setting the buffer-local variable @code{show-trailing-whitespace} to
 @code{t}.  Then Emacs displays trailing whitespace, using the face
@@ -1418,6 +1431,8 @@
 @cindex non-breaking space
 @cindex non-breaking hyphen
 @cindex soft hyphen
address@hidden escape-glyph face
address@hidden nobreak-space face
   Some address@hidden characters have the same appearance as an
 @acronym{ASCII} space or hyphen (minus) character.  Such characters
 can cause problems if they are entered into a buffer without your

=== modified file 'doc/emacs/frames.texi'
--- a/doc/emacs/frames.texi     2014-10-23 16:54:25 +0000
+++ b/doc/emacs/frames.texi     2014-10-24 09:13:01 +0000
@@ -961,6 +961,10 @@
 bottom when the end of the buffer is shown.  You can not over-scroll
 when the entire buffer is visible.
 
address@hidden scroll-bar face
+  The visual appearance of the scroll bars is controlled by the
address@hidden face.
+
 @node Drag and Drop
 @section Drag and Drop
 @cindex drag and drop

=== modified file 'doc/emacs/killing.texi'
--- a/doc/emacs/killing.texi    2014-10-04 02:36:49 +0000
+++ b/doc/emacs/killing.texi    2014-10-24 09:13:01 +0000
@@ -588,6 +588,7 @@
 @table @kbd
 @findex mouse-set-secondary
 @kindex M-Drag-Mouse-1
address@hidden secondary-selection face
 @item M-Drag-Mouse-1
 Set the secondary selection, with one end at the place where you press
 down the button, and the other end at the place where you release it

=== modified file 'doc/emacs/search.texi'
--- a/doc/emacs/search.texi     2014-10-04 16:46:21 +0000
+++ b/doc/emacs/search.texi     2014-10-24 09:13:01 +0000
@@ -86,6 +86,7 @@
 the cursor moves to just after the first @samp{FOO}.
 
 @cindex faces for highlighting search matches
address@hidden isearch face
   At each step, Emacs highlights the @dfn{current match}---the buffer
 text that matches the search string---using the @code{isearch} face
 (@pxref{Faces}).  The current search string is also displayed in the
@@ -1280,6 +1281,8 @@
 like @code{query-replace}.
 
 @cindex faces for highlighting query replace
address@hidden query-replace face
address@hidden lazy-highlight face
   These commands highlight the current match using the face
 @code{query-replace}.  They highlight other matches using
 @code{lazy-highlight} just like incremental search (@pxref{Incremental