GNU bug report logs - #22683
25.1.50; auto-composition-mode

Previous Next

Full log

Message #8 received at 22683 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: rms <at> gnu.org
Cc: 22683 <at> debbugs.gnu.org
Subject: Re: bug#22683: 25.1.50; auto-composition-mode
Date: Mon, 15 Feb 2016 21:50:17 +0200

> From: Richard Stallman <rms <at> gnu.org>
> Date: Mon, 15 Feb 2016 12:46:07 -0500
> 
> 
> The doc string of auto-composition-mode says:
> 
> ======================================================================
> With a prefix argument ARG, enable Auto Composition mode if ARG
> is positive, and disable it otherwise.  If called from Lisp,
> enable the mode if ARG is omitted or nil.
> ======================================================================
> 
> The doc string suggests (but does not clearly say) that ARG present
> and non-nil disables the mode.
> 
> In fact, using M-:, (auto-composition-mode t) enables the mode.
> (auto-composition-mode 0) disables the mode.
> (auto-composition-mode 1) enables it.
> 
> It seems this calls for a doc string fix, or a code fix.

We say these things for every mode, so this issue is not specific to
this particular mode.

I believe the fix is to add "also" to the last sentence (as in "also
enable the mode if ..."), but is this really so serious to require
changes in hundreds of doc strings?

Previous Next

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