The docstring for
(bit-shift-left x n) says only "Bitwise shift left". It does not define either
Below the docstring is a link to the source code, but it does not immediately clear up the question, as it delegates to a method of clojure.lang.Number.
Suggestion: enhance the docstring along the lines of "Bitwise shift x left by n bits".
P.S. Does left mean more-significant everywhere nowadays? As Clojure gets implemented in JS and even stranger environments, could the docstring clarify whether Clojure's left and right have a specified mathematical significance (as the Java Language Specification does) or have host-dependent significance?
P.P.P.S. Likewise in the ClojureScript docstrings.