From: Kim F. Storm <storm@cua.dk>
Date: Thu, 14 Nov 2002 11:44:16 +0000 (+0000)
Subject: (syms_of_buffer) <mode-line-format>: Document symbol
X-Git-Tag: ttn-vms-21-2-B4~12470
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ed4632553c0d767e7e0a4cadad60129ff993f359;p=emacs.git

(syms_of_buffer) <mode-line-format>: Document symbol
dependency on `risky-local-variable' and the :propertize form.
---

diff --git a/src/buffer.c b/src/buffer.c
index 3aa03fc32de..25264806dc6 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5259,8 +5259,13 @@ A value of nil means don't display a mode line.
 For a symbol, its value is used (but it is ignored if t or nil).
  A string appearing directly as the value of a symbol is processed verbatim
  in that the %-constructs below are not recognized.
+ Note that unless the symbol is marked as a `risky-local-variable', all
+ properties in any strings, as well as all :eval and :propertize forms 
+ in the value of that symbol will be ignored.
 For a list of the form `(:eval FORM)', FORM is evaluated and the result
  is used as a mode line element.
+For a list of the form `(:propertize ELT PROPS...)', ELT is displayed
+ with the specified properties PROPS applied.
 For a list whose car is a symbol, the symbol's value is taken,
  and if that is non-nil, the cadr of the list is processed recursively.
  Otherwise, the caddr of the list (if there is one) is processed.