请在2024 Clojure现状调查!中分享您的想法。

欢迎!请查看关于页面以了解更多关于这个工作方式的信息。

+2
语法和读取器
重新标记

在定义变量时,我们可以在符号和绑定之间提供文档字符串。例如:

(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等中使用文档字符串将会很方便。

1 答案

0

我们对这个话题有一个旧的工单,已经经过了几轮补丁,实际上做得正确是非常棘手的。 :)

https://clojure.atlassian.net/browse/CLJ-1148

...