Comment made by: jafingerhut
Ben, the correct order for adding doc strings to a defn is like this:
(defn ^:static ^clojure.lang.ChunkBuffer chunk-buffer
"Returns a fixed length buffer of the given capacity."
^clojure.lang.ChunkBuffer [capacity]
(clojure.lang.ChunkBuffer. capacity))
with the doc string after the symbol that names the function, but before the argument vector.
The Clojure compiler gives no errors or warnings if you do it in the order, that is true. However, it also does not attach the provided string as documentation metadata, and thus (doc fn-name) will not print the doc string.
Could you update the patch to put the proposed doc strings in the correct place?
