A docstring is an optional string placed after a function’s name in `defn`. It describes the function and is stored in the resulting Var’s metadata, where documentation tools can find it. section 2.1.1
(defn hello "A function to say hello" ; #1 [person] (str "Hello " person)) (clojure.repl/doc hello) ; #2 ;; ------------------------- ;; user/hello ;; ([person]) ;; A function to say hello ;; ([person]) ;; A function to say hello ; #3 ;; nil (:doc (meta #'hello)) ; #4 ;; "A function to say hello"
The `hello` definition shows the string in place. `clojure.repl/doc` displays it alongside the function’s arity, while `(:doc (meta #'hello))` retrieves it directly. section 2.1.1
