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

Question

据我所知，使用def创建没有绑定但有:doc元数据的var（或在不绑定/更改绑定值的情况下更改现有var的: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元数据的var是不可能的”部分是不准确的，但这实际上不影响补丁本身提出的更改的正确性和实用性。仅为了澄清，此：forms元数据实际上反映了def的实现方式（而当前的实现方式则没有）

[(def symbol) (def symbol doc-string? init)]

Answer 4

评论者：bronsa

当然！我并没有质疑这个工单，只是告诉你，你可以使用显式元数据语法（正如描述所暗示的，你可能不知道的话）

Answer 5

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