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

Diff of /emacs/lispref/display.texi

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

revision 1.194 by cyd, Fri Nov 18 02:51:12 2005 UTC revision 1.195 by cyd, Sun Nov 20 15:23:33 2005 UTC
# Line 1859  the first face fails to specify a partic Line 1859  the first face fails to specify a partic
1859  next face gets a chance.  However, the @code{default} face must  next face gets a chance.  However, the @code{default} face must
1860  specify all attributes.  specify all attributes.
1861    
   Any attribute can have the value @code{:ignore-defface}.  The effect  
 of this is identical to @code{unspecified}.  It exists because of an  
 technical ambiguity in giving attributes the value @code{unspecified}.  
 @xref{Attribute Functions}.  
   
1862    Some of these font attributes are meaningful only on certain kinds of    Some of these font attributes are meaningful only on certain kinds of
1863  displays---if your display cannot handle a certain attribute, the  displays---if your display cannot handle a certain attribute, the
1864  attribute is ignored.  (The attributes @code{:family}, @code{:width},  attribute is ignored.  (The attributes @code{:family}, @code{:width},
# Line 2056  This function sets one or more attribute Line 2051  This function sets one or more attribute
2051  for frame @var{frame}.  If @var{frame} is @code{nil}, it sets  for frame @var{frame}.  If @var{frame} is @code{nil}, it sets
2052  the attribute for all frames, and the defaults for new frames.  the attribute for all frames, and the defaults for new frames.
2053    
 Unless you know what you're doing, don't set an attribute to  
 @code{unspecified}.  This is ambiguous---it is unclear whether it  
 means to unspecify the value stored in the frame-local copies of the  
 face (which means reverting to the original face spec), or the value  
 in the face spec itself.  What you probably want is to set the  
 attribute to @code{:ignore-defface}.  This forces the attribute value  
 to be acquired from some other face during face merging.  
   
2054  The extra arguments @var{arguments} specify the attributes to set, and  The extra arguments @var{arguments} specify the attributes to set, and
2055  the values for them.  They should consist of alternating attribute names  the values for them.  They should consist of alternating attribute names
2056  (such as @code{:family} or @code{:underline}) and corresponding values.  (such as @code{:family} or @code{:underline}) and corresponding values.

Legend:
Removed from v.1.194  
changed lines
  Added in v.1.195

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