欢迎!请查看关于页面以了解更多关于这个工作方式的信息。
在定义变量时,我们可以在符号和绑定之间提供文档字符串。例如:
(def some-var "this var serves as an example" 42)
然而,我们目前无法在defonce中这样做。我们必须手动提供元数据如下。
(defonce ^{:doc "this var serves as another example"} other-example nil)
在Clojure的未来版本中,能够像在def、defn等中使用文档字符串将会很方便。
我们对这个话题有一个旧的工单,已经经过了几轮补丁,实际上做得正确是非常棘手的。 :)
https://clojure.atlassian.net/browse/CLJ-1148