# HG changeset patch # User Kim F. Storm # Date 1037274256 0 # Node ID 55b6e3969474bb27c07c13c3c5a01eb159c88ad8 # Parent bf28f5db93ce39915a8786c7458862304ba3513e (syms_of_buffer) : Document symbol dependency on `risky-local-variable' and the :propertize form. diff -r bf28f5db93ce -r 55b6e3969474 src/buffer.c --- a/src/buffer.c Thu Nov 14 11:44:03 2002 +0000 +++ b/src/buffer.c Thu Nov 14 11:44:16 2002 +0000 @@ -5259,8 +5259,13 @@ 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.