deliver 文档字符串应描述其返回值

Question

在交付承诺时，知道交付是否成功可能是有用的（如果已在另一线程中交付，则可能失败）。

目前看来，{{deliver}} 函数似乎通过在成功时返回一个真值（承诺本身）和在失败时返回一个假值（{{nil}}）来传达这一点。如果这是故意的，文档字符串应说明这一点，以便用户可以放心地依赖它。

在CLJ-1038中，Rich选择了不描述返回值；我不确定这是否是因为他不愿意完整指定返回值（承诺与{{nil}}）即使部分描述它（真与假）也行。

Answer 1

参考：https://clojure.atlassian.net/browse/CLJ-1542（由gfredericks报告）