Subject: bug#21695: 25.0.50; Change most occurrences of `setq' in Emacs manual to `customize-set-variable'

From: Drew Adams <[email-masked]>
Date: Sun, 29 Aug 2021 22:36:43 +0000

> > @Drew: You should review your answer on Emacs Stack
> > Exchange because it is misleading.
> 
> Thanks for letting me know, but that's too vague.
> It's not clear to me what you think is misleading.
> 
> Maybe add a comment there, or here, or send me an
> email?  You've apparently reviewed it and found
> something misleading.  What did you find?

Dunno if this is what you had in mind, but I just
added mention of minor-mode variables - use the
minor-mode function to set them.  That's a special
case, and yes, in general using a Customize function
to set such an option directly is not TRT.

(The other thing mentioned in (elisp) `Init Syntax'
is buffer-local variables, which doesn't apply to
user options.)
___

IMHO, not only the Emacs manual but the Init File
sections of the Elisp manual as well should be
updated to _generally guide against_ using `setq'
for user options.