>Tim, as someone already mentioned, the multi-page Java code you posted from >"the Clojure core" is actually one file from the Java ASM library, copied >into the Clojure Github repository from one version of that library >available from here:
Hmmm, I didn't see that in the documentation :-) Thanks for the warning. In order to write the book I took a clone of the repository at a particular time with the intention of "walking up the diffs" after I had a clue about the details. >There are 18,821 lines of Java code in that library, as it has been copied >into Clojure in the src/jvm/clojure/asm directory. Oh, good. That means I can read the library documentation :-) > I would strongly >recommend that you *not* spend a lot of time reading and documenting that >code, if you want to document things that are unique to Clojure. That >library is used by other projects besides Clojure. Between Clojure 1.5.1 >and Clojure 1.6.0, a new version of it was copied over the older version >that was used before then. > > http://dev.clojure.org/jira/browse/CLJ-713 > >That will likely happen again in a future Clojure release, to better >support JDK8: and again for JDK9... and again for JDK10... and again for... If Clojure needs the library then it needs to be documented. I am using a "reference" model. If code references a function then document the function. If no code references the library then it won't get documented. Any living piece of software is going to have changes made but I'm hoping that the core remain reasonably stable. Assuming, of course, I can distinguish core code. Reading code is SO much fun :-) Anyway, thanks for the warning. Tim Daly -- 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.
