2024 年 Clojure 状况调查! 中分享您的想法。

欢迎!请参阅 关于 页面获取更多关于如何使用本站的信息。

0
Clojure

本文介绍
http://groups.google.com/group/clojure/browse_thread/thread/84de74740928da76 1. 我提到了为什么这很重要以及原因。感谢您的考虑。

2 个答案

0

评论者:hiredman

Clojure 的文档系统分为两个部分

  1. 文档字符串附加到对象的元数据上

  2. doc 宏(以及一些其他工具)从对象中读取文档字符串并显示它们

这两部分共同工作,没有 doc 宏,文档字符串只是占用运行时内存的注释,而没有文档字符串,doc 宏则没有任何用途。

文档字符串主要挂载在 var 元数据和命名空间元数据上。

对于多方法和方法协议,文档字符串挂载在 var 上。

对于多方法和协议的实现,没有明确的 var 用于附加文档信息,也不清楚如何查找这些文档字符串。

因此,为了支持 defmethods 和协议实现的文档,需要对 doc 进行增强,并做一些设计工作,所以创建一个用于提出设计的维基页面是一个好主意。

0
参考: https://clojure.atlassian.net/browse/CLJ-1037(由 alex+import 报告)
...