欢迎!请参阅关于页面,了解更多关于其工作方式的信息。
在定义变量时,我们可以在符号和绑定之间提供文档字符串。例如:
(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