<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&#39;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&#39;t work well.  What are the common problems and how do I fix them?</div>
<div><br></div><div>I&#39;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">&lt;<a href="mailto:vegard_oye@hotmail.com">vegard_oye@hotmail.com</a>&gt;</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>
&gt; <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&#39;s been neglected for some time<br>
now ...<br>
<br>
I&#39;ve recently been looking to Frank&#39;s User Guide for vim-mode as a<br>
guide to improving Evil&#39;s documentation.[1] What is really needed<br>
-- and both your blog post and Frank&#39;s guide underline this -- is<br>
an overview of the different states and how they relate to Emacs&#39;<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 &quot;Settings&quot; 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&#39;<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>