; Caveats about using :eval in 'mode-line-format'

* doc/lispref/modes.texi (Mode Line Data): Warn against more
infinite-recursion cases in ':eval' in mode line.  Reported by
Nicolas P. Rougier <nicolas.rougier@inria.fr>.

(cherry picked from commit ae2463796f236b8ee2cef3b5e38bffa13abd2233)

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index c00a9264f2be70a6d4594370b3da520b13d47c5b..bea2fd3fc7bf71c97ad0bfd3a1b07b8d48fa5a40 100644 (file)
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -2191,8 +2191,9 @@ construct.)
 @item (:eval @var{form})
 A list whose first element is the symbol @code{:eval} says to evaluate
 @var{form}, and use the result as a string to display.  Make sure this
-evaluation cannot load any files, as doing so could cause infinite
-recursion.
+evaluation cannot load any files, nor calls functions like
+@code{posn-at-point} or @code{window-in-direction}, which themselves
+evaluate the mode line, as doing so could cause infinite recursion.
 
 @item (:propertize @var{elt} @var{props}@dots{})
 A list whose first element is the symbol @code{:propertize} says to