bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion

bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion

[Drew Adams]

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@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'
 

bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion

[Drew Adams]

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.

bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion

[Drew Adams]

> 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.

bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion

[Drew Adams]

ping

bug#12294: 24.2.50; `C-h m' in Buffer Menu - regresssion

[Chong Yidong]

"Drew Adams" <drew.adams@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.