/[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.148 by lute, Wed Feb 23 08:57:16 2005 UTC revision 1.149 by rms, Sun Mar 6 18:12:47 2005 UTC
# Line 102  binding @code{redisplay-dont-pause} to a Line 102  binding @code{redisplay-dont-pause} to a
102  @defvar redisplay-dont-pause  @defvar redisplay-dont-pause
103  If this variable is non-@code{nil}, pending input does not  If this variable is non-@code{nil}, pending input does not
104  prevent or halt redisplay; redisplay occurs, and finishes,  prevent or halt redisplay; redisplay occurs, and finishes,
105  regardless of whether input is available.  This feature is available  regardless of whether input is available.
 as of Emacs 21.  
106  @end defvar  @end defvar
107    
108    You can request a display update, but only if no input is pending,    You can request a display update, but only if no input is pending,
# Line 1180  then each element can be any of these po Line 1179  then each element can be any of these po
1179  A face name (a symbol or string).  A face name (a symbol or string).
1180    
1181  @item  @item
1182  Starting in Emacs 21, a property list of face attributes.  This has the  A property list of face attributes.  This has the form (@var{keyword}
1183  form (@var{keyword} @var{value} @dots{}), where each @var{keyword} is a  @var{value} @dots{}), where each @var{keyword} is a face attribute
1184  face attribute name and @var{value} is a meaningful value for that  name and @var{value} is a meaningful value for that attribute.  With
1185  attribute.  With this feature, you do not need to create a face each  this feature, you do not need to create a face each time you want to
1186  time you want to specify a particular attribute for certain text.  specify a particular attribute for certain text.  @xref{Face
1187  @xref{Face Attributes}.  Attributes}.
1188    
1189  @item  @item
1190  A cons cell of the form @code{(foreground-color . @var{color-name})} or  A cons cell of the form @code{(foreground-color . @var{color-name})} or
# Line 1340  as an integer. Line 1339  as an integer.
1339    
1340  @defun overlay-buffer overlay  @defun overlay-buffer overlay
1341  This function returns the buffer that @var{overlay} belongs to.  It  This function returns the buffer that @var{overlay} belongs to.  It
1342  returns @code{nil}, if @var{overlay} has been deleted.  returns @code{nil} if @var{overlay} has been deleted.
1343  @end defun  @end defun
1344    
1345  @defun delete-overlay overlay  @defun delete-overlay overlay
# Line 1909  mean.  Note that in general, more than o Line 1908  mean.  Note that in general, more than o
1908  given piece of text; when that happens, the attributes of all the faces  given piece of text; when that happens, the attributes of all the faces
1909  are merged to specify how to display the text.  @xref{Displaying Faces}.  are merged to specify how to display the text.  @xref{Displaying Faces}.
1910    
1911    In Emacs 21, any attribute in a face can have the value    Any attribute in a face can have the value @code{unspecified}.  This
1912  @code{unspecified}.  This means the face doesn't specify that attribute.  means the face doesn't specify that attribute.  In face merging, when
1913  In face merging, when the first face fails to specify a particular  the first face fails to specify a particular attribute, that means the
1914  attribute, that means the next face gets a chance.  However, the  next face gets a chance.  However, the @code{default} face must
1915  @code{default} face must specify all attributes.  specify all attributes.
1916    
1917    Some of these font attributes are meaningful only on certain kinds of    Some of these font attributes are meaningful only on certain kinds of
1918  displays---if your display cannot handle a certain attribute, the  displays---if your display cannot handle a certain attribute, the
# Line 2043  that is being pressed.  If it is @code{n Line 2042  that is being pressed.  If it is @code{n
2042  is used.  is used.
2043  @end table  @end table
2044    
2045    The attributes @code{:overline}, @code{:strike-through} and    In older versions of Emacs, before @code{:family}, @code{:height},
2046  @code{:box} are new in Emacs 21.  The attributes @code{:family},  @code{:width}, @code{:weight}, and @code{:slant} existed, these
2047  @code{:height}, @code{:width}, @code{:weight}, @code{:slant} are also  attributes were used to specify the type face.  They are now
2048  new; previous versions used the following attributes, now semi-obsolete,  semi-obsolete, but they still work:
 to specify some of the same information:  
2049    
2050  @table @code  @table @code
2051  @item :font  @item :font
# Line 2060  A non-@code{nil} value specifies a bold Line 2058  A non-@code{nil} value specifies a bold
2058  A non-@code{nil} value specifies an italic font.  A non-@code{nil} value specifies an italic font.
2059  @end table  @end table
2060    
2061    For compatibility, you can still set these ``attributes'' in Emacs 21,    For compatibility, you can still set these ``attributes'', even
2062  even though they are not real face attributes.  Here is what that does:  though they are not real face attributes.  Here is what that does:
2063    
2064  @table @code  @table @code
2065  @item :font  @item :font
# Line 2195  they are used automatically to handle ce Line 2193  they are used automatically to handle ce
2193  @end defun  @end defun
2194    
2195  @defun set-face-font face font &optional frame  @defun set-face-font face font &optional frame
2196  This function sets the font of face @var{face}.  This function sets the font of face @var{face}.  This actually sets
2197    the attributes @code{:family}, @code{:width}, @code{:height},
2198  In Emacs 21, this actually sets the attributes @code{:family},  @code{:weight}, and @code{:slant} according to the font name
2199  @code{:width}, @code{:height}, @code{:weight}, and @code{:slant}  @var{font}.
 according to the font name @var{font}.  
   
 In Emacs 20, this sets the font attribute.  Once you set the font  
 explicitly, the bold and italic attributes cease to have any effect,  
 because the precise font that you specified is used.  
2200  @end defun  @end defun
2201    
2202  @defun set-face-bold-p face bold-p &optional frame  @defun set-face-bold-p face bold-p &optional frame
2203  This function specifies whether @var{face} should be bold.  If  This function specifies whether @var{face} should be bold.  If
2204  @var{bold-p} is non-@code{nil}, that means yes; @code{nil} means no.  @var{bold-p} is non-@code{nil}, that means yes; @code{nil} means no.
2205    This actually sets the @code{:weight} attribute.
 In Emacs 21, this sets the @code{:weight} attribute.  
 In Emacs 20, it sets the @code{:bold} attribute.  
2206  @end defun  @end defun
2207    
2208  @defun set-face-italic-p face italic-p &optional frame  @defun set-face-italic-p face italic-p &optional frame
2209  This function specifies whether @var{face} should be italic.  If  This function specifies whether @var{face} should be italic.  If
2210  @var{italic-p} is non-@code{nil}, that means yes; @code{nil} means no.  @var{italic-p} is non-@code{nil}, that means yes; @code{nil} means no.
2211    This actually sets the @code{:slant} attribute.
 In Emacs 21, this sets the @code{:slant} attribute.  
 In Emacs 20, it sets the @code{:italic} attribute.  
2212  @end defun  @end defun
2213    
2214  @defun set-face-underline-p face underline-p &optional frame  @defun set-face-underline-p face underline-p &optional frame
# Line 2519  differently from the default face. Line 2508  differently from the default face.
2508  @cindex faces, automatic choice  @cindex faces, automatic choice
2509    
2510  @cindex Font-Lock mode  @cindex Font-Lock mode
2511    Starting with Emacs 21, a hook is available for automatically    This hook is used for automatically assigning faces to text in the
2512  assigning faces to text in the buffer.  This hook is used for part of  buffer.  It is part of the implementation of Font-Lock mode.
 the implementation of Font-Lock mode.  
2513    
2514  @tindex fontification-functions  @tindex fontification-functions
2515  @defvar fontification-functions  @defvar fontification-functions
# Line 2572  for @var{maximum} can make this function Line 2560  for @var{maximum} can make this function
2560  many fonts match the pattern.  many fonts match the pattern.
2561  @end defun  @end defun
2562    
   These additional functions are available starting in Emacs 21.  
   
2563  @defun x-family-fonts &optional family frame  @defun x-family-fonts &optional family frame
2564  @tindex x-family-fonts  @tindex x-family-fonts
2565  This function returns a list describing the available fonts for family  This function returns a list describing the available fonts for family
# Line 3031  buffer.  The default is to use the @code Line 3017  buffer.  The default is to use the @code
3017    
3018    The @code{display} text property (or overlay property) is used to    The @code{display} text property (or overlay property) is used to
3019  insert images into text, and also control other aspects of how text  insert images into text, and also control other aspects of how text
3020  displays.  These features are available starting in Emacs 21.  The value  displays.  The value of the @code{display} property should be a
3021  of the @code{display} property should be a display specification, or a  display specification, or a list or vector containing several display
3022  list or vector containing several display specifications.  The rest of  specifications.  The rest of this section describes several kinds of
3023  this section describes several kinds of display specifications and what  display specifications and what they mean.
 they mean.  
3024    
3025  @menu  @menu
3026  * Specified Space::      Displaying one space with a specified width.  * Specified Space::      Displaying one space with a specified width.
# Line 3344  string. Line 3329  string.
3329    
3330    To display an image in an Emacs buffer, you must first create an image    To display an image in an Emacs buffer, you must first create an image
3331  descriptor, then use it as a display specifier in the @code{display}  descriptor, then use it as a display specifier in the @code{display}
3332  property of text that is displayed (@pxref{Display Property}).  Like the  property of text that is displayed (@pxref{Display Property}).
 @code{display} property, this feature is available starting in Emacs 21.  
3333    
3334    Emacs can display a number of different image formats; some of them    Emacs can display a number of different image formats; some of them
3335  are supported only if particular support libraries are installed on  are supported only if particular support libraries are installed on

Legend:
Removed from v.1.148  
changed lines
  Added in v.1.149

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