🚀 go-pugleaf

In message <9103181721.AA19643@wendy-fate.UU.NET> Kyle Jones wrote:
>
>  > And of course it's still wrong if you rebind any keys, because the doc 
>  > string contains the default bindings, instead of using \\[...].
> 
> Those who change the default key bindings can change the
> documentation as well. 

I think that's very unreasonable.

It's really easy to change keybindings.  It's a lot more work to change
doc strings.  So much so that most people aren't going to do it, and
are just going to suffer through with no online help.  Which is ok if
you want to punish them for not having the same taste in keybindings that
you do.

I suppose you've never used a system in which the default keybindings
weren't what you wanted.

> Using \\[...] isn't going to fix up the Info document or the quick
> reference card.

I never use those.  I read them when first learning how to use VM, but
now that I've got the concepts, I only use online help for bindings and
things.

>> Now if only you could lose that irrational fear of substitute-command-keys,
>> here is a correct version of the documentation strings for
>> 'vm-mode and 'vm:
> 
> My fear is hardly irrational.  The keymap lookups caused by rampant
> use of \\[...] really slow down program startup.  I noticed this
> phenomena first in vkill.el, a package that doesn't have nearly as
> many bindings as VM.  I once used substitute-command-keys but now I
> just don't think it's worth the wait.

What wait?  It only happens when you ask for help!  On every system I
use, it takes far longer to redisplay the help buffer than it does to
cons up the docstring!

		-- Jamie