Re: Marking old window variables obsolete

[Óscar Fuentes]

"Drew Adams" <address@hidden> writes:

> Sheesh.  If that's the only way users can be encouraged to adopt the new
> machinery, that doesn't say much about how appealing it is, does it?
>
> Users generally have little problem adopting new features that they find (or
> even suspect might be) useful.

Really? Even if we supposse that everybody reads the NEWS file and are
willing to adapt their perfectly working configuration on accordance,
your approach would limit the set of acceptable new features to those
which are indisputably more useful than the functionality they
replace/modify for the taste of (almost?) all the Emacs user population.

What's reasonable, IMHO, is to add clear instructions to the docstrings
of those variables and functions explaining how to migrate to the new
machinery. If those instructions turn to be too complex, it is an
indication that the new system is not so good. A good practice is to do
those kind of documentation tasks at the design phase of the new
machinary as a preemptive usability check.