On Wed, Jun 13, 2012 at 6:27 PM, fenton <fenton.trav...@gmail.com> wrote: > Then I head over to > lein: https://github.com/technomancy/leiningen, well this one is better than > most install instructions, but still IMO, isn't as simple to follow as my > instructions. Which I'd agree I should update to use Lein 2. However it > doesn't talk about the dependencies of Lein, like rlwrap, since > understandably that is out of scope, but for a newbie, it's darn handy to > have that stuff.
rlwrap is actually only needed for lein1, and if you try to use lein1 without it, it will warn you and tell you that you should install it when you run it. > Then we get back to marmalade. The steps to install package.el are quite a > few. You should put ~/.emacs.d/ on your load path, you've got to (require > 'package). It doesn't mention anything about (package-initialize), which > seems to be helpful. The first thing on the dev.clojure.org Emacs page is a link to clojure-mode that has all these steps in the readme. I've reported an issue with the Marmalade maintainer about the misleading instructions on his site, (http://code.google.com/p/marmalade/issues/detail?id=20) but so far that has been ignored, so this is one place where the working instructions can't be kept in the canonical place. > Next I want to get swank-slime-clojure server going. > Do I need slime? I don't really know. So I head over > to: https://github.com/technomancy/swank-clojure, which is not bad, but it > doesn't tell me that I have to do a 'lein deps' after I put the entry into > my emacs. If you had to do `lein deps` at this point that would be a bug in Leiningen; it should never be necessary to run that manually. If this is reproducible can you report it in the issue tracker? > It doesn't tell me that if I jack-in and then modify my > project.clj that I need to re-jack-in. Face plant. I still don't know if I > need both clojure and clojure-contrib in my project.clj files or not. This is another place where people are often mislead by out-of-date documentation. The official docs have the story: http://dev.clojure.org/display/design/Where+Did+Clojure.Contrib+Go > I did find myself getting a bit angry writing this, because I'd really like > to see clojure displace java, but I think its fair to say that there is a > gap in helping people who have little > emacs/clojure/leiningen/swank/slime/cdt/lisp exposure getting on board. I > think there is value in reducing that complexity as far as possible to let > them get going doing some coding. It's also very important not to get people sidetracked into learning Emacs when they want to learn Clojure. People who know their way around Emacs can generally figure out how to install packages, but people who want to learn Clojure need to focus on that and only learn one thing at a time. > I think github is a better place to document this stuff than confluence. > Confluence just doesn't have the prettifying abilities of github. I agree with this; Confluence is not very good. However, having documentation under the *.clojure.org umbrella makes it much more likely to be found. > I don't want to piss of the good people of this community that I'd like to > be accepted into...is that possible? I hope so. :) I appreciate that you're trying to help. It's just that if you hang around enough in IRC you find a lot of confused newcomers who are following out of date information they read on a blog somewhere that made perfect sense a year ago but is just misleading now. I think a lot of the pain will be reduced now that Emacs 24 is out, but if there are other places where the docs need improvement let's focus on that. It sounds like CDT is one of those places? I don't use it myself, but the Swank readme probably needs more detailed coverage of it. -Phil -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en
