Universal repl-friendly doc helper

[vemv]

clojure.repl/doc is quite limited.

I'm thinking of a replacement that does the following:

• Integrate the doc behavior of https://github.com/nedap/speced.def
  • Improvable point: spec annotations don't show up as part of the arglsits
  • Maybe: recursively traverse all relevant specs and expand them
• Integrate with javadocs
  • Ideally, just print a link so the user can choose to click on it, instead of eagerly opening Chrome/Swing etc
• Integrate with http://clojuredocs.org/
  • Print a few examples + link to the clojuredocs entry
• Improve minimalistically over the clojure.core docstrings
  • fill-column style isn't very readable

The idea is to have a 'megamorphic' macro that tries to gather all possible relevant info and print it at once. 0 to N 'providers' (:doc metadata, speced.def, clojuredocs) may match.

The result would be an IDE-agnostic tool, that would bring a lot of smartness / interactivity to the table - particularly for folks stuck into a not particularly Clojurey workflow.

[vemv]

Here's a silly emacs snippet that I'm using atm:

(-> Integer/parseInt quote ((fn [x]

                              (cond
                                (not (symbol? x)) ;; ::some-spec
                                (eval \`(nedap.speced.def/doc ~(eval x)))

                                (try ;; Integer/parseInt
                                  (eval x)
                                  false
                                  (catch Exception _
                                    true))
                                (eval \`(clojure.java.javadoc/javadoc ~(-> x str (clojure.string/split #"/") first symbol)))

                                (try ;; Integer
                                  (-> x eval class?)
                                  (catch Exception _
                                    false))
                                (eval \`(clojure.java.javadoc/javadoc ~(-> x eval)))

                                true ;; +, clojure.core/+
                                (eval \`(nedap.speced.def/doc ~(-> x))))

                              )))