Re: 23.0.50; `mode-name' variable docs out of date WRT features

[Stefan Monnier]

>> > But this value doesn't work everywhere.  There are files (bookmark.el
>> > is one) that expect the value to be a string, as the manual says.
>> 
>> > Stefan, could you redo that differently, then ack?
>> 
>> No, it'd be a step backward.

> Er, but the documentation _does_ say: "Pretty name of current buffer's
> major mode (a string)." ... and presumably many coders have relied on
> that description... what should they do?

Adapt?
It's not like we never break backward compatibility in such minor ways,
is it?


        Stefan


PS: I would more cynically say that even if the doc had always said it
could contain any "mode-line-format" thingy, 99% of those same coders
would still not have written code to handle the non-string case.
My experience dealing with Elisp packages is that it's mostly written
by copying bad examples on the web rather than by reading the doc.