使用文档字符串消除def的歧义性

Question

据我所知，不可能使用def创建一个未绑定但有:doc元数据的变量（也不可能在不绑定/更改绑定值的情況下更改现有变量的:doc元数据）。

此更改阐明了def的可行用法；即，如果您提供doc-string，您必须也提供init。

Answer 1

评论者：jcr

这个页面是“clojure def docstring”在谷歌上的第一个结果。鉴于这是一个简单的文档改进，它能合并到下一个版本中吗？

Answer 2

评论者：bronsa

通知：您可以直接做`(def ^{:doc "my-doc-here} var)`，但对于此类用例，建议使用`declare`。

Answer 3

评论者：jcr

Nicola，正确；严格来说，“不可能使用def创建一个未绑定但有:doc元数据的变量”部分的问题描述是不正确的，但这实际上不影响补丁本身提出的更改的正确性和实用性。为了澄清，这个：forms元数据实际上反映了{{def}}的实现方式（而当前的并没有）。

[(定义符号) (定义符号 doc-string? 初始化)]

Answer 4

评论者：bronsa

当然！我并没有质疑这个工单，只是告诉你你可以使用显式的元数据语法，以防你不知道（因为描述中似乎暗示了这一点）

Answer 5

参考： https://clojure.atlassian.net/browse/CLJ-2159（由 alex+import 报告）