Re: master 48aacbf292 2/2: Make many seldom-used generalized variables obsolete

[Lars Ingebrigtsen]

Ihor Radchenko <yantar92@gmail.com> writes:

> Well. What about `replace-buffer-contents'?

It's a very specialised function used for reverting.  (Also see
`replace-region-contents'.)

> Sure, but not all the generalized variables were obsoleted. Do you claim
> that all the remaining generalized variables are simple enough to not
> require documentation?

I went through them all and obsoleted all the weird ones, so yes.  But I
may have missed some, of course.

> I am pretty sure that third-party setters may still do non-obvious
> things.

I don't really control code that's not in Emacs, unfortunately.  😀

> Would it be possible to accept docstring in gv-define-setter and then
> display it in the help buffer for the relevant variable?

It would be possible, but then we'd just be encouraging people to write
illegible code.