diff options
Diffstat (limited to 'src/fontset.c')
| -rw-r--r-- | src/fontset.c | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/src/fontset.c b/src/fontset.c index 7af6782a37c..4aa2fb7b2c7 100644 --- a/src/fontset.c +++ b/src/fontset.c @@ -1499,7 +1499,16 @@ Optional 5th argument ADD, if non-nil, specifies how to add FONT-SPEC to the previously set font specifications for CHARACTERS. If it is `prepend', FONT-SPEC is prepended to the existing font specifications. If it is `append', FONT-SPEC is appended. By default, FONT-SPEC -overwrites the previous settings. */) +overwrites the previous settings. + +For reliable results, this function should be called before any +of CHARACTERS were displayed in the current Emacs session. In +particular, if some of CHARACTERS are displayed using character +compositions, those compositions will be cached after they are first +produced, and the cached values include the font used for displaying +the composed characters -- calling this function will not affect the +font recorded in the cache of compositions, thus they will continue +to be shown using the fonts from before the call. */) (Lisp_Object fontset, Lisp_Object characters, Lisp_Object font_spec, Lisp_Object frame, Lisp_Object add) { |