Improve docstring for reify

Question

I think the docs for reify says a lot about how but misses the point for what "reify" does.

`

user=> (doc reify)

clojure.core/reify
([& opts+specs])
Macro
reify is a macro with the following structure:

(reify options specs)
...
`

Proposed: Add a definition of what reify does:

`

user=> (doc reify)

clojure.core/reify
([& opts+specs])
Macro
reify creates an anonymous instance implementing a protocol or interface.
reify is a macro with the following structure:

(reify options specs)
...
`

Patch: clj-2488-2.patch

Screened by: Alex Miller

Answer 1

Comment made by: alexmiller

Added -2 patch with a small rewrite, retained attribution.

Answer 2

Reference: https://clojure.atlassian.net/browse/CLJ-2488 (reported by alex+import)