为什么 clojure.core 中的某些 Clojure 函数没有记录？

Question

我发现 clojure.core 中的一些 Clojure 函数没有记录。

其中一些是私有函数。 但是其他像await1 chunk-*和await1等是公开的，但没有文档。 是不是有什么特殊的意义，还是只是因为它们是新增的功能？

谢谢！

Answer 1

clojure.core 中未记录的函数被认为是实现的一部分，而不是公共接口的一部分（因此缺少文档字符串是有意的）。 在某些情况下，未记录的函数由公共宏的扩展调用，因此它们必须是公共的。