评论者:hiredman
Clojure 的文档系统分为两个部分
文档字符串附加到对象的元数据上
doc 宏(以及一些其他工具)从对象中读取文档字符串并显示它们
这两部分共同工作,没有 doc 宏,文档字符串只是占用运行时内存的注释,而没有文档字符串,doc 宏则没有任何用途。
文档字符串主要挂载在 var 元数据和命名空间元数据上。
对于多方法和方法协议,文档字符串挂载在 var 上。
对于多方法和协议的实现,没有明确的 var 用于附加文档信息,也不清楚如何查找这些文档字符串。
因此,为了支持 defmethods 和协议实现的文档,需要对 doc 进行增强,并做一些设计工作,所以创建一个用于提出设计的维基页面是一个好主意。