1 files changed, 4 insertions, 0 deletions

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index d044763523b..9e83e4a9bcc 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2463,6 +2463,10 @@ you can say:
 @example
 (apply #'insert (cdr (string-glyph-split string))))
 @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
 
 When a buffer is displayed with line numbers (@pxref{Display Custom,,,