GNU bug report logs - #23071
25.0.90; doc string of `global-eldoc-mode'

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Sun, 20 Mar 2016 19:46:01 UTC

Severity: minor

Tags: fixed

Found in version 25.0.90

Fixed in version 26.1

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 23071 in the body.
You can then email your comments to 23071 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#23071; Package emacs. (Sun, 20 Mar 2016 19:46:01 GMT) Full text and rfc822 format available.
Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Sun, 20 Mar 2016 19:46:02 GMT) Full text and rfc822 format available.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.90; doc string of `global-eldoc-mode'
Date: Sun, 20 Mar 2016 12:45:35 -0700 (PDT)

This is surely incorrect, according to the code:

 "Enable 'eldoc-mode' in all buffers where it's applicable."

The command `global-eldoc-mode' is a toggle.  It does not _enable_
`eldoc-mode' in all "applicable" buffers; it toggles whether they are
enabled.

Also, the doc string should say what it means by "applicable" buffers
for Eldoc mode.  So far, the doc string is less than helpful - actually
harmful.


In GNU Emacs 25.0.90.3 (i686-w64-mingw32)
 of 2016-03-19
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --host=i686-w64-mingw32 --without-dbus 'CFLAGS=-static
 -static-libgcc' LDFLAGS=-static-libgcc'
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#23071; Package emacs. (Sat, 30 Apr 2016 23:09:01 GMT) Full text and rfc822 format available.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 23071 <at> debbugs.gnu.org
Subject: Re: bug#23071: 25.0.90; doc string of `global-eldoc-mode'
Date: Sun, 01 May 2016 01:08:35 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> This is surely incorrect, according to the code:
>
>  "Enable 'eldoc-mode' in all buffers where it's applicable."
>
> The command `global-eldoc-mode' is a toggle.  It does not _enable_
> `eldoc-mode' in all "applicable" buffers; it toggles whether they are
> enabled.
>
> Also, the doc string should say what it means by "applicable" buffers
> for Eldoc mode.  So far, the doc string is less than helpful - actually
> harmful.

I've now fixed these two things.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no
Added tag(s) fixed. Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Sat, 30 Apr 2016 23:09:02 GMT) Full text and rfc822 format available.
bug marked as fixed in version 25.2, send any further explanations to 23071 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com> Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Sat, 30 Apr 2016 23:09:02 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sun, 29 May 2016 11:24:11 GMT) Full text and rfc822 format available.
bug unarchived. Request was from Glenn Morris <rgm <at> gnu.org> to control <at> debbugs.gnu.org. (Sun, 04 Dec 2016 02:50:11 GMT) Full text and rfc822 format available.
bug Marked as fixed in versions 26.1. Request was from Glenn Morris <rgm <at> gnu.org> to control <at> debbugs.gnu.org. (Sun, 04 Dec 2016 02:50:11 GMT) Full text and rfc822 format available.
bug No longer marked as fixed in versions 25.2. Request was from Glenn Morris <rgm <at> gnu.org> to control <at> debbugs.gnu.org. (Sun, 04 Dec 2016 02:50:11 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sun, 01 Jan 2017 12:24:21 GMT) Full text and rfc822 format available.
This bug report was last modified 8 years and 232 days ago.

Previous Next

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