I'm not sure why this code was written this way, but Marginalia has no problem using docstrings. Compare it's own docs:
http://fogus.me/fun/marginalia/ and the code they were generated from: https://github.com/fogus/marginalia/blob/master/src/marginalia/core.clj Cheers, Dave On Mon, Aug 22, 2011 at 9:43 AM, Laurent PETIT <laurent.pe...@gmail.com> wrote: > Hi, > > I was curious to see Marginalia in action, but was then surprised to see a > lot of code like this: > > ;; Produce a total score as the sum of the points awarded during each round. > > (defn total [strategy] > > (reduce + (:points strategy))) > > That is, no more docstring, which is replaced in favor of a comment > preprending the form it comments. > > > > Isn't it an annoyance to loose, in the REPL, the possibility to have nice > descriptions when sending e.g. (doc total)? > > > 2011/8/19 Christian Romney <xmlb...@gmail.com> >> >> Hi all, >> >> As part of my attempt to learn Clojure, I've cooked up a simple >> Prisoner's Dilemma simulation. I'd love any feedback the group would >> care to provide about my implementation, as I'm eager to improve. I've >> got thick skin so fire away! >> >> Annotated source: >> http://xmlblog.github.com/prisoners/ >> >> Github Project: >> https://github.com/xmlblog/prisoners >> >> Needless to say, forks and contributions would be most welcome. >> >> Thanks! >> >> -- >> 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 > > -- > 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 -- 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
