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, |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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 |