Show
Ignore:
Timestamp:
2006年08月10日 11時19分54秒 (2 years ago)
Author:
miyoshi
Message:

Sync up with Emacs CVS HEAD.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/lispref/display.texi

    r4131 r4140  
    18581858  The effect of using a face is determined by a fixed set of @dfn{face 
    18591859attributes}.  This table lists all the face attributes, and what they 
    1860 mean.  Note that in general, more than one face can be specified for a 
    1861 given piece of text; when that happens, the attributes of all the faces 
    1862 are merged to specify how to display the text.  @xref{Displaying Faces}. 
     1860mean.  You can specify more than one face for a given piece of text; 
     1861Emacs merges the attributes of all the faces to determine how to 
     1862display the text.  @xref{Displaying Faces}. 
    18631863 
    18641864  Any attribute in a face can have the value @code{unspecified}.  This 
    …… 
    20492049@subsection Face Attribute Functions 
    20502050 
    2051   You can modify the attributes of an existing face with the following 
    2052 functions.  If you specify @var{frame}, they affect just that frame; 
    2053 otherwise, they affect all frames as well as the defaults that apply to 
    2054 new frames. 
     2051  This section describes the functions for accessing and modifying the 
     2052attributes of an existing face. 
    20552053 
    20562054@defun set-face-attribute face frame &rest arguments 
    2057 This function sets one or more attributes of face @var{face} 
    2058 for frame @var{frame}.  If @var{frame} is @code{nil}, it sets 
    2059 the attribute for all frames, and the defaults for new frames. 
     2055This function sets one or more attributes of face @var{face} for frame 
     2056@var{frame}.  The attributes you specify this way override whatever 
     2057the @code{defface} says. 
    20602058 
    20612059The extra arguments @var{arguments} specify the attributes to set, and 
    …… 
    20742072sets the attributes @code{:width}, @code{:weight} and @code{:underline} 
    20752073to the corresponding values. 
     2074 
     2075If @var{frame} is @code{t}, this function sets the default attributes 
     2076for new frames.  Default attribute values specified this way override 
     2077the @code{defface} for newly created frames. 
     2078 
     2079If @var{frame} is @code{nil}, this function sets the attributes for 
     2080all existing frames, and the default for new frames. 
    20762081@end defun 
    20772082 
    …… 
    20812086that means the selected frame (@pxref{Input Focus}). 
    20822087 
    2083 If @var{frame} is @code{t}, the value is the default for 
    2084 @var{face} for new frames. 
     2088If @var{frame} is @code{t}, this returns whatever new-frames default 
     2089value you previously specified with @code{set-face-attribute} for the 
     2090@var{attribute} attribute of @var{face}.  If you have not specified 
     2091one, it returns @code{nil}. 
    20852092 
    20862093If @var{inherit} is @code{nil}, only attributes directly defined by 
    …… 
    21362143with older Emacs versions, you can use the following functions to set 
    21372144and examine the face attributes which existed in those versions. 
     2145They use values of @code{t} and @code{nil} for @var{frame} 
     2146just like @code{set-face-attribute} and @code{face-attribute}. 
    21382147 
    21392148@defun set-face-foreground face color &optional frame 
    …… 
    21922201 
    21932202  These functions examine the attributes of a face.  If you don't 
    2194 specify @var{frame}, they refer to the default data for new frames. 
    2195 They return the symbol @code{unspecified} if the face doesn't define any 
    2196 value for that attribute. 
     2203specify @var{frame}, they refer to the selected frame; @code{t} refers 
     2204to the default data for new frames.  They return the symbol 
     2205@code{unspecified} if the face doesn't define any value for that 
     2206attribute. 
    21972207 
    21982208@defun face-foreground face &optional frame inherit