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

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 27b74a9d233c20625409902e2a123c7c43ed9660..b24a89af9e09a47f55c618f1aa190742c0a41950 100644 (file)
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -2227,8 +2227,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