swap!, reset!, swap-vals!, 和 reset-vals! 函数的 Docstring/参数一致性

Question

Clojure 中，swap!、swap-vals!、reset! 和 reset-vals! 的参数和 docstring 始终是指 {{atom}} 和 {{newval}}，但在 ClojureScript 中并非如此。

在 ClojureScript 中，{{a}} 代替 {{atom}} 作为参数名，而对于重置函数，参数名为 {{new-value}}，而 docstring 指的是 {{newval}}（在 ClojureScript 中，在 reset! 的 docstring 末尾有一个将参数作为 {{new-value}} 的引用）。

建议修改参数和 docstring，以保持与 Clojure 的一致性。

Answer 1

评论者：namenu

谢谢您不断提出低垂的果实。 =D

还包括针对类似不一致性的修复方案 compare-and-set!。

Answer 2

评论者：mfikes

CLJS-2965.patch LGTM，并且它将 compare-and-set! 扩展为是一个很好的发现。在 CI 中通过。

Answer 3

参考：https://clojure.atlassian.net/browse/CLJS-2965（由 mfikes 报告）