Re: Incompatible change without "warning"

[Stefan Monnier]

> The current documentation for these related functions uses different argument
> names which I think is confusing:

I don't think it's confusing:
- `defvaralias' creates a variable alias.
  Neither of the two variables is known to be "old" or "new" or "obsolete".
  One is the "base", the other is the "alias".
- define-obsolete-variable-alias OTOH just *uses* defvaralias in one specific
  context (in order to preserve backward compatibility witha now obsolete
  variable), so the names can be more specific.

>  - Function: defvaralias variable new &optional docstring

That would sound wrong to me: the documentation should generally refer to
what a function *does*, not to how the function is used.


        Stefan