changeset 52663:5f70316d2ec5

(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.
author Lute Kamstra <lute@gnu.org>
date Mon, 29 Sep 2003 10:19:05 +0000
parents d46a70300b43
children 0e2f2cae953c
files lispref/modes.texi
diffstat 1 files changed, 7 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/modes.texi	Mon Sep 29 10:08:11 2003 +0000
+++ b/lispref/modes.texi	Mon Sep 29 10:19:05 2003 +0000
@@ -1223,6 +1223,11 @@
 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 @@
    '(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 @@
 
 @example
 @group
-((-3 . "%p")
+((-3 "%p")
  (size-indication-mode (8 " of %I"))
 @end group
 @group