[Emacs-diffs] /srv/bzr/emacs/trunk r109443: Manual fixes for frame-background-mode.

[Chong Yidong]

------------------------------------------------------------
revno: 109443
fixes bug: http://debbugs.gnu.org/7774
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sun 2012-08-05 17:24:55 +0800
message:
  Manual fixes for frame-background-mode.
  
  * doc/custom.texi (Face Customization): Move discussion of face
  inheritance here, from Faces section.
  
  * doc/display.texi (Faces): Document frame-background-mode.
  
  * doc/lispref/display.texi (Defining Faces): Move documentation of
  frame-background-mode to the Emacs manual (Bug#7774).
modified:
  doc/emacs/ChangeLog
  doc/emacs/custom.texi
  doc/emacs/display.texi
  doc/lispref/ChangeLog
  doc/lispref/display.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-07-28 15:12:12 +0000
+++ b/doc/emacs/ChangeLog       2012-08-05 09:24:55 +0000
@@ -1,3 +1,10 @@
+2012-08-05  Chong Yidong  <address@hidden>
+
+       * display.texi (Faces): Document frame-background-mode (Bug#7774).
+
+       * custom.texi (Face Customization): Move discussion of face
+       inheritance here, from Faces section.
+
 2012-07-21  Eli Zaretskii  <address@hidden>
 
        * frames.texi (Mouse Commands): Fix the description of mouse-2.

=== modified file 'doc/emacs/custom.texi'
--- a/doc/emacs/custom.texi     2012-07-13 14:25:59 +0000
+++ b/doc/emacs/custom.texi     2012-08-05 09:24:55 +0000
@@ -450,11 +450,14 @@
 specify any special value for the attribute.  You can activate a
 checkbox to specify or unspecify its attribute.
 
-  Most faces only specify a few attributes (in the above example,
address@hidden only specifies the foreground color).
-Emacs has a special face, @code{default}, whose attributes are all
-specified; it determines the attributes left unspecified by other
-faces.
+  A face does not have to specify every single attribute; in fact,
+most faces only specify a few attributes.  In the above example,
address@hidden only specifies the foreground color.
+Any unspecified attribute is taken from the special face named
address@hidden, whose attributes are all specified.  The
address@hidden face is the face used to display any text that does not
+have an explicitly-assigned face; furthermore, its background color
+attribute serves as the background color of the frame.
 
   The @samp{Hide Unused Attributes} button, at the end of the
 attribute list, hides the unspecified attributes of the face.  When

=== modified file 'doc/emacs/display.texi'
--- a/doc/emacs/display.texi    2012-06-17 05:13:40 +0000
+++ b/doc/emacs/display.texi    2012-08-05 09:24:55 +0000
@@ -475,18 +475,26 @@
 prompts for a regular expression, and displays only faces with names
 matching that regular expression (@pxref{Regexps}).
 
address@hidden frame-background-mode
   It's possible for a given face to look different in different
 frames.  For instance, some text terminals do not support all face
 attributes, particularly font, height, and width, and some support a
-limited range of colors.
+limited range of colors.  In addition, most Emacs faces are defined so
+that their attributes are different on light and dark frame
+backgrounds, for reasons of legibility.  By default, Emacs
+automatically chooses which set of face attributes to display on each
+frame, based on the frame's current background color.  However, you
+can override this by giving the variable @code{frame-background-mode}
+a address@hidden value.  A value of @code{dark} makes Emacs treat all
+frames as if they have a dark background, whereas a value of
address@hidden makes it treat all frames as if they have a light
+background.
 
 @cindex background color
 @cindex default face
-  You can customize a face to alter its appearance, and save those
-changes for future Emacs sessions.  @xref{Face Customization}.  A face
-does not have to specify every single attribute; often it inherits
-most attributes from another face.  Any ultimately unspecified
-attribute is taken from the face named @code{default}.
+  You can customize a face to alter its attributes, and save those
+customizations for future Emacs sessions.  @xref{Face Customization},
+for details.
 
   The @code{default} face is the default for displaying text, and all
 of its attributes are specified.  Its background color is also used as

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-08-04 14:33:00 +0000
+++ b/doc/lispref/ChangeLog     2012-08-05 09:24:55 +0000
@@ -1,3 +1,8 @@
+2012-08-05  Chong Yidong  <address@hidden>
+
+       * display.texi (Defining Faces): Move documentation of
+       frame-background-mode to the Emacs manual (Bug#7774).
+
 2012-08-04  Chong Yidong  <address@hidden>
 
        * syntax.texi (Syntax Basics): Rearrange the text for clarity.

=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi  2012-07-15 00:52:16 +0000
+++ b/doc/lispref/display.texi  2012-08-05 09:24:55 +0000
@@ -2040,14 +2040,6 @@
 specify a face to use.  In the vast majority of cases, this is not
 necessary; it is preferable to simply use faces directly.
 
address@hidden frame-background-mode
-This option, if address@hidden, specifies the background type to use for
-interpreting face definitions.  If it is @code{dark}, then Emacs treats
-all frames as if they had a dark background, regardless of their actual
-background colors.  If it is @code{light}, then Emacs treats all frames
-as if they had a light background.
address@hidden defopt
-
 @node Face Attributes
 @subsection Face Attributes
 @cindex face attributes