1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00

Gently discourage use of lsh (bug#56641)

* lisp/subr.el (lsh): Note the general preference for `ash`.
* lisp/emacs-lisp/shortdoc.el (number): Remove entry for `lsh`.
It was identical to that for `ash` which is misleading.
Shortdoc is very helpful for finding the right function to use,
and `lsh` is just for compatibility at this point.
This commit is contained in:
Mattias Engdegård 2022-07-20 11:24:49 +02:00
parent 563bf2fae5
commit b70a00d9bf
2 changed files with 4 additions and 4 deletions

View file

@ -524,7 +524,10 @@ was called."
"Return VALUE with its bits shifted left by COUNT.
If COUNT is negative, shifting is actually to the right.
In this case, if VALUE is a negative fixnum treat it as unsigned,
i.e., subtract 2 * `most-negative-fixnum' from VALUE before shifting it."
i.e., subtract 2 * `most-negative-fixnum' from VALUE before shifting it.
This function is provided for compatibility. In new code, use `ash'
instead."
(when (and (< value 0) (< count 0))
(when (< value most-negative-fixnum)
(signal 'args-out-of-range (list value count)))