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

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 21695 <at> debbugs.gnu.org, hmelman <at> gmail.com, rms <at> gnu.org
Subject: bug#21695: [External] : bug#21695: 25.0.50; Change most occurrences of `setq' in Emacs manual to `customize-set-variable'? Really?
Date: Thu, 02 Sep 2021 20:17:02 +0300

> From: Drew Adams <drew.adams <at> oracle.com>
> CC: "21695 <at> debbugs.gnu.org" <21695 <at> debbugs.gnu.org>,
>         "hmelman <at> gmail.com"
> 	<hmelman <at> gmail.com>
> Date: Thu, 2 Sep 2021 17:08:01 +0000
> 
> > An option which cannot be usefully change via setq
> > mentions that in its doc string (or at least it
> > should; if it doesn't, that's a documentation bug),
> 
> Yes, but what about 3rd-party code that doesn't
> bother saying that in doc strings?  Sure, it's
> wrong; but does that recommendation solve the
> problem?

Our manual documents Emacs, not every piece of Lisp out there.  If
customizable options in 3rd-party packages need different
instructions, the developers of those packages should document them.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.