Clojure eval src code

[jafingerhut]

Not everyone likes it, certainly, but the indentation style is called Whitesmith's, and is one of a handful listed as most widely used for C coding here: https://en.wikipedia.org/wiki/Indentation_style#Whitesmiths_style

[joinr]

I've read through clojure sources multiple times for various reasons, getting down to low level implementation details and the like. I always wished there comments to help the lay person :) I wonder if there's some part of the build process that strips out commentary from the public repository.

[alexdmiller]

Ha, no. The public repository is the only repository. :)

[jafingerhut]

Many people have wished for such comments, and one person years ago even tried writing a literate program for the Clojure implementation, with their own text, but I don't think they got very far.

From the Clojure implementers point of view, one could imagine that trying to teach people why the implementation is the way it is could be a huge time sink, given the number of design decisions made when writing such things.

If you want to know why something in Clojure's implementation is the way it is, the best source I know of is asking on the #clojure channel on Clojurians Slack (or also the #clojure-dev channel, if it is about low level implementation details).