GNU bug report logs - #10844
24.0.93; Slightly unclear help text about remapped commands

Previous Next

Full log

View this message in rfc822 format

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Ingebrigtsen'" <larsi <at> gnus.org>, <10844 <at> debbugs.gnu.org>
Subject: bug#10844: 24.0.93; Slightly unclear help text about remapped commands
Date: Sun, 19 Feb 2012 07:25:36 -0800

> kill-buffer is an interactive built-in function in `C source code'.
> It is remapped to `ido-kill-buffer', which is bound to C-x k.
> 
> I was puzzled [by] what this meant.

Remapping: the "mapping" is between commands and keys.  It should be sufficient
to add only a couple of words here to make things clearer.  E.g.

Its keys have been remapped to `ido-kill-buffer': `C-x k', `C-M-whatever',...
^^^^^^^^

It is fine for the regular doc, which explains things more precisely and at more
length, to speak of one _command_ being remapped to another _command_.  But here
it might be better to speak of one command's key bindings being remapped to
another command.

That said, I don't have a problem with the current help in this context.  I
mainly want us to avoid becoming verbose here just in order to make clear what
admittedly could be confusing.

Previous Next

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