<div>I find Evil suffers from some of the same problems as viper does:</div><div><br></div><div>1) Discoverability. In Emacs C-h b is useful. In vim, :help is wonderful. What does Evil give me that informs me what I can actually type? Referring to vim docs only goes so far. For example, typing d C-h doesn't bring up what I can then type (iw, or whatever).</div>
<div><br></div><div>2) How do I fix my problem? viper and Evil suffer from the same thing: a low-adoption alternative. There will always be a foo-mode out there that doesn't work well. What are the common problems and how do I fix them?</div>
<div><br></div><div>I'm an elisp idiot. I get by on copy/paste from others.</div><div><br></div><div><div><div><br><div class="gmail_quote">On Wed, Feb 22, 2012 at 5:24 AM, Vegard Øye <span dir="ltr"><<a href="mailto:vegard_oye@hotmail.com">vegard_oye@hotmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 2012-02-20 21:19 +0100, Leo Alekseyev wrote:<br>
<br>
> <a href="http://dnquark.com/blog/2012/02/emacs-evil-ecumenicalism/" target="_blank">http://dnquark.com/blog/2012/02/emacs-evil-ecumenicalism/</a><br>
<br>
Interesting blog post! It highlights some areas in which the current<br>
documentation is rather lacking -- it's been neglected for some time<br>
now ...<br>
<br>
I've recently been looking to Frank's User Guide for vim-mode as a<br>
guide to improving Evil's documentation.[1] What is really needed<br>
-- and both your blog post and Frank's guide underline this -- is<br>
an overview of the different states and how they relate to Emacs'<br>
keymap hierarchy. Rebinding keys and configuring the initial state<br>
should also be dealt with in more detail, with instructive examples.<br>
<br>
Furthermore, maybe the "Settings" chapter should be moved to the end,<br>
since it might be a bit overwhelming up-front. (On the topic of<br>
settings, we could perhaps add an `evil-want-sparse-insert-state'<br>
customization variable for disabling most of the key bindings of<br>
Insert state.)<br>
<br>
[1] <a href="http://www.emacswiki.org/emacs/VimMode_-_User%27s_Guide" target="_blank">http://www.emacswiki.org/emacs/VimMode_-_User%27s_Guide</a><br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Vegard<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
implementations-list mailing list<br>
<a href="mailto:implementations-list@lists.ourproject.org">implementations-list@lists.ourproject.org</a><br>
<a href="https://lists.ourproject.org/cgi-bin/mailman/listinfo/implementations-list" target="_blank">https://lists.ourproject.org/cgi-bin/mailman/listinfo/implementations-list</a><br>
</div></div></blockquote></div><br></div></div></div>