位左移和位右移中哪个参数对应哪个？

Question

（bit-shift-left x n）的文档字符串仅说明“位左移”，并没有定义x或n。

在文档字符串下方有一个到源代码的链接，但它并没有立即澄清问题，因为它委托给了clojure.lang.Number的一个方法。

建议：加强文档字符串，例如：“将x向左位移n位”。

附言：现在左边的意思是不是全书都意味着“更重要的”？随着Clojure在JS甚至是更奇怪的环境中实现，文档字符串能否明确指出Clojure的左右是否具有规定的数学意义（如Java语言规范中所述）或主机依赖的意义？

又是附言，bit-shift-right也是如此。

又是备注，在ClojureScript文档字符串中也同样如此。

Answer 1

提交jira：https://clojure.atlassian.net/browse/CLJ-2608

Answer 2

你可以在REPL中轻松获取答案

clj Clojure 1.10.1 (bit-shift-left 1 1) 2 (bit-shift-left 1 2) 4 (bit-shift-left 1 3) 8 (bit-shift-left 1 4) 16 (bit-shift-left 2 1) 4 (bit-shift-left 2 3) 16

这些答案将是正确的。即使你在一个SNES上运行定制的16位JVM，或者在一个奇特的JavaScript引擎上运行；)

Comments

问题是关于改进文档字符串。