The received wisdom in most programming circles is that comments should
explain intent, rather then simply transliterating the code into a human
language (eg, English). For example, comments like this are discouraged:
(def a 42) ;; Define a to be 42.
However, as a Clojure noob, I would _love_ to have a tool that explains
even the syntactic level of an arbitrary piece of Clojure code. If it
could use metadata from (say) function definitions to go deeper, so much
the better.
I Googled around but didn't find anything very close. Might anyone know
of any efforts in this direction?
-r
--
http://www.cfcl.com/rdm Rich Morin
http://www.cfcl.com/rdm/resume r...@cfcl.com
http://www.cfcl.com/rdm/weblog +1 650-873-7841
Software system design, development, and documentation