在阅读 clojure.test
的 API 文档时,我发现其中一些文档字符串已经过时/模糊不清,觉得在这里报告可能会有所帮助。
对于 clojure.test/report 的当前文档字符串包括以下文本
有关'报告'的参数类型,请参阅 test_is.clj 文件顶部的文档。
更多信息。
源文件 test_is.clj
已在 一段时间以前 更名为 test.clj
。
我认为这个文档字符串可能指的是 这里。
也许可以改为类似这样的内容?
有关 report
的参数类型,请查阅 "EXTENDING TEST-IS" 下的命名空间文档。
注意,命名空间的文档字符串也有些模糊,它要求读者
要了解更多的事件类型,请参阅代码中的示例。
作为读者,我不确定应该在何处寻找这些示例。