為什么 clojure.core 中的某些 Clojure 函數沒有記錄？

Question

我發現 clojure.core 中的一些 Clojure 函數沒有記錄。

其中一些是私有函數。 但是其他像await1 chunk-*和await1等是公開的，但沒有文檔。 是不是有什么特殊的意義，還是只是因為它們是新增的功能？

謝謝！

Answer 1

clojure.core 中未記錄的函數被認為是實現的一部分，而不是公共接口的一部分（因此缺少文檔字符串是有意的）。 在某些情況下，未記錄的函數由公共宏的擴展調用，因此它們必須是公共的。