GNU bug report logs - #12294
24.2.50; `C-h m' in Buffer Menu - regresssion

Previous Next

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

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

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: 24.2.50; `C-h m' in Buffer Menu - regresssion
Date: Tue, 28 Aug 2012 08:12:42 -0700

This is a regression for users.  C-h m in the buffer menu is not
user-oriented anymore.  Instead, it tells you of matters that are
essentially implementation-oriented.
 
Before the doc-string change to Buffer-menu-mode, C-h m told users what
the mode was actually about and how to use it - which is the purpose of
C-h m.  It listed important key bindings.
 
Now, C-h m tells you how the mode is invoked!  Of course, if you used
C-h m then it has already been invoked!
 
And then it goes on to tell you what the mode's parent mode is, etc.
This is essentially information for Emacs-Lisp programmers or Emacs
developers.  Some users might be interested, and yes, they can click the
link to `tabulated-list-mode' to get information about IT.
 
But users are now losing out on a description of BUFFER MENU mode, which
is what C-h m should give them, in Buffer Menu mode.
 
It is all well and good to factor code, for the benefit of Emacs Dev
maintenance etc.  But please do not forget about Emacs USERS.  Please
restore the information that was there before, helping users understand
and learn how to use Buffer Menu mode.  Please do not just send users
off to learn about Tabulated List mode.
 

In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600)
 of 2012-08-26 on MARVIN
Bzr revision: 109788 dmantipov <at> yandex.ru-20120827041533-3cy7pdjdqz14o90c
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.6) --no-opt --enable-checking --cflags
 -ID:/devel/emacs/libs/libXpm-3.5.8/include
 -ID:/devel/emacs/libs/libXpm-3.5.8/src
 -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include
 -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include
 -ID:/devel/emacs/libs/giflib-4.1.4-1/include
 -ID:/devel/emacs/libs/jpeg-6b-4/include
 -ID:/devel/emacs/libs/tiff-3.8.2-1/include
 -ID:/devel/emacs/libs/gnutls-3.0.9/include
 -ID:/devel/emacs/libs/libiconv-1.13.1-1-dev/include
 -ID:/devel/emacs/libs/libxml2-2.7.8/include/libxml2'
 

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <12294 <at> debbugs.gnu.org>
Subject: RE: bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion
Date: Tue, 28 Aug 2012 08:21:29 -0700

Similarly, the doc string of `buffer-menu' and `buffer-menu-other-window' no
longer tell users about the `?' key.  Please restore such information to these
doc strings also.

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <12294 <at> debbugs.gnu.org>
Subject: RE: bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion
Date: Tue, 28 Aug 2012 08:53:22 -0700

> Similarly, the doc string of `buffer-menu' and 
> `buffer-menu-other-window' no
> longer tell users about the `?' key.  Please restore such 
> information to these
> doc strings also.

Also, the doc string for `Buffer-menu-delete-backwards' no longer mentions how
to execute the deletion (`x').  Users are getting less help now than before.

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <12294 <at> debbugs.gnu.org>
Subject: RE: bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion
Date: Sun, 16 Sep 2012 16:31:55 -0700

ping

Message #19 received at 12294-done <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> gnu.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 12294-done <at> debbugs.gnu.org
Subject: Re: bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion
Date: Wed, 28 Nov 2012 15:12:49 +0800

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

> Before the doc-string change to Buffer-menu-mode, C-h m told users what
> the mode was actually about and how to use it - which is the purpose of
> C-h m.  It listed important key bindings.
>  
> Now, C-h m tells you how the mode is invoked!  Of course, if you used
> C-h m then it has already been invoked!

Fixed, thanks.

Previous Next

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