From: Pistos Christou Date: 2006-05-04T22:38:03+09:00 Subject: Re: Ruby & Emacs John Gabriele wrote: > I just had a brief look at Diakonos. Seems nice and clean: just one > main .rb file for the editor, and one conf file. Sadly, aside from a > few comments here and there in the code and in the conf file, Diakonos > looks to be entirely undocumented. > > There *is* a readme describing how to install (which is (happily) > trivial), but no mention anywhere how to use the editor (though, > passing "--help" (I guessed that one) gives 4 lines of info). I also > guessed that Ctrl-q exits the editor, but that's it. You are absolutely correct: There is very little user documentation. I actually have more solid plans to come up with more material (online documentation, in-application help) to give a better out-of-box experience within the next two releases. I've walked a few people through getting started, but I completely agree that a quick start walkthrough of some kind is definitely in order. That and sprucing up the F1 page by, perhaps, organizing into groups and showing the most commonly used keybindings higher up. I've also entertained notions of making a "for people coming from emacs" conf file which would override most keystrokes to match emacs. Thanks for trying Diakonos. Pistos -- Posted via http://www.ruby-forum.com/.