1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00

; Improve documentation of 'string-glyph-split'

* doc/lispref/display.texi (Size of Displayed Text):
* lisp/emacs-lisp/subr-x.el (string-glyph-split): Document a
caveat (bug#79576).
This commit is contained in:
Eli Zaretskii 2025-10-05 11:04:34 +03:00
parent 0aa44112b6
commit cd400326b2
2 changed files with 8 additions and 1 deletions

View file

@ -2459,6 +2459,10 @@ you can say:
@example @example
(apply #'insert (cdr (string-glyph-split string)))) (apply #'insert (cdr (string-glyph-split string))))
@end example @end example
Caveat: for this function to recognize and process character
compositions, @code{auto-composition-mode} must be enabled, and the
current buffer must be displayed in some window.
@end defun @end defun
When a buffer is displayed with line numbers (@pxref{Display Custom,,, When a buffer is displayed with line numbers (@pxref{Display Custom,,,

View file

@ -365,7 +365,10 @@ substring that does not include newlines."
This takes into account combining characters and grapheme clusters: This takes into account combining characters and grapheme clusters:
if compositions are enabled, each sequence of characters composed if compositions are enabled, each sequence of characters composed
on display into a single grapheme cluster is treated as a single on display into a single grapheme cluster is treated as a single
indivisible unit." indivisible unit.
Caveat: for this function to recognize characters compositions, the
automatic compositions should be enabled (see `auto-composition-mode')
and the current buffer must be displayed in some window."
(declare (side-effect-free t)) (declare (side-effect-free t))
(let ((result nil) (let ((result nil)
(start 0) (start 0)