I love the idea. A gotchas section of some sort could be useful. For instance, a detail about `case` to consider mentioning is that Java Constants don't work as tests.
ryans-mbp:~% cat test.clj (let [incoming-character Character/LINE_SEPARATOR] (println "case w/ constant" (case incoming-character Character/LINE_SEPARATOR :line-separator :unknown)) (println "case w/ int " (case incoming-character 13 :line-separator :unknown))) ryans-mbp:~% java -jar $CLOJURE test.clj case w/ constant :unknown case w/ int :line-separator I think I understand why this doesn't work but it feels like it should work. And without prior knowledge, I don't think I would assume that constants don't work. Ryan On Wed, Dec 7, 2016 at 4:57 PM, Alex Miller <a...@puredanger.com> wrote: > This is a cool idea so thanks for working on it. > > I was going to buy this (as I buy most of the Clojure books that come out) > but $48 for an unfinished ebook put me off so I didn't. I totally get why a > physical book of this length would be that much (because paper is expensive > right now), but I don't get it with the ebook (particularly EA)? I know you > likely have little control over this, so it's not really fair to complain > to you, but maybe you can feed it back to your editor. > > While pretty thorough, that case description is still lacking a > description of one important feature - grouping multiple tests that have > the same output in a list. Basically this line from the doc string: > > (test-constant1 ... test-constantN) result-expr > > > Example: > > (case 3 > (1 2 3) "1, 2, or 3" > 4 "4" > (5 6 7) "5, 6, or 7") > > ;;=> "1, 2, or 3" > > I think most people are unaware of this feature and seems like it's the > kind of thing you'd want in the book. > > Alex > > On Wednesday, December 7, 2016 at 12:14:29 PM UTC-6, Renzo Borgatti wrote: >> >> Hi all, >> >> I'm very happy to announce the early access of a new book: "Clojure >> Standard Library - Annotated Reference" by Manning. Although it's a >> reference of the roughly 700+ functions (and macros) coming out of the box >> with the Clojure jar file, it is not designed to read as a boring list. >> Think of all the Stackoverflow, mailing lists, ClojureDocs, articles, blogs >> all mashed together to create an essay for each function. The book website >> is: >> >> https://www.manning.com/books/clojure-standard-library >> >> It contains now a total of 4 chapters (around 200 pages) or ~30 >> functions, starting with some of the most important available in the >> standard library. Here's a sample of “case" how it appears on the book >> http://tinyurl.com/hekc55u to give you an idea of the kind of treatment >> they get. Needless to say any feedback is highly appreciated. Any question >> please shout here, personally at reborg*at*reborg.net or on the book >> forum. >> >> Regards, >> Renzo >> > -- > 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 unsubscribe from this group and stop receiving emails from it, send an > email to clojure+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. > -- 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 unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.