From: Lute Kamstra <lute@gnu.org>
Date: Mon, 29 Sep 2003 10:19:05 +0000 (+0000)
Subject: (Mode Line Data): Explain when symbols in mode-line
X-Git-Tag: ttn-vms-21-2-B4~8705
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a232a240af268dc8379f909e9c2c40a56f3f43b9;p=emacs.git

(Mode Line Data): Explain when symbols in mode-line
constructs should be marked as risky.
Change cons cell into proper list.
(Mode Line Variables): Change cons cell into proper list.
---

diff --git a/lispref/modes.texi b/lispref/modes.texi
index b53246fd9fc..b346dad99cc 100644
--- a/lispref/modes.texi
+++ b/lispref/modes.texi
@@ -1223,6 +1223,11 @@ symbol whose value is void.
 There is one exception: if the value of @var{symbol} is a string, it is
 displayed verbatim: the @code{%}-constructs are not recognized.
 
+Unless @var{symbol} is marked as ``risky'' (i.e., it has a
+non-@code{nil} @code{risky-local-variable} property), all properties in
+any strings, as well as all @code{:eval} and @code{:propertize} forms in
+the value of that symbol will be ignored.
+
 @item (@var{string} @var{rest}@dots{}) @r{or} (@var{list} @var{rest}@dots{})
 A list whose first element is a string or list means to process all the
 elements recursively and concatenate the results.  This is the most
@@ -1302,7 +1307,7 @@ directory.
    '(which-func-mode ("" which-func-format "--"))
    '(line-number-mode "L%l--")
    '(column-number-mode "C%c--")
-   '(-3 . "%p")
+   '(-3 "%p")
    "-%-"))
 @end group
 @end example
@@ -1360,7 +1365,7 @@ also specifies addition of the @code{help-echo} text property.
 
 @example
 @group
-((-3 . "%p")
+((-3 "%p")
  (size-indication-mode (8 " of %I"))
 @end group
 @group