Commit 52fd4006 authored by Eli Zaretskii's avatar Eli Zaretskii

Minor improvement of documentation of '(when CONDITION . SPEC)'

* doc/lispref/display.texi (Other Display Specs): Add a caveat
to using the '(when CONDITION . SPEC)' display specs.
parent f872b65b
Pipeline #916 passed with stage
in 27 minutes and 3 seconds
......@@ -4853,6 +4853,16 @@ and the buffer position where the @code{display} property was found,
respectively. Both positions can be different when @code{object} is a
string.
Note that @var{condition} will only be evaluated when redisplay
examines the text where this display spec is located, so this feature
is best suited for conditions that are relatively stable, i.e.@:
yield, for each particular buffer position, the same results on every
evaluation. If the results change for the same text location, e.g.,
if the result depends on the position of point, then the conditional
specification might not do what you want, because redisplay examines
only those parts of buffer text where it has reasons to assume that
something changed since the last display cycle.
@node Display Margins
@subsection Displaying in the Margins
@cindex display margins
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment