]> git.eshelyaron.com Git - emacs.git/commitdiff
Improve wording of lsh docstring
authorStefan Kangas <stefankangas@gmail.com>
Sat, 22 Feb 2025 17:15:37 +0000 (18:15 +0100)
committerEshel Yaron <me@eshelyaron.com>
Tue, 4 Mar 2025 20:47:50 +0000 (21:47 +0100)
* lisp/subr.el (lsh): Improve wording of docstring.

(cherry picked from commit e15dcb2db5c40e90ea2a21391af5addb9e778779)

lisp/subr.el

index 93e7e20dc5e876a50cca6932306bdf99bbb1b8b7..6b08a36c713360cda3a1b6b5ec3ba57c260c7830 100644 (file)
@@ -611,10 +611,10 @@ 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.
 
-Most uses of this function turn out to be mistakes.  We recommend
-to use `ash' instead, unless COUNT could ever be negative, and
-if, when COUNT is negative, your program really needs the special
-treatment of negative COUNT provided by this function."
+Most uses of this function turn out to be mistakes.  We recommend using
+`ash' instead, unless COUNT could ever be negative, in which case your
+program should only use this function if it specifically requires the
+special handling of negative COUNT."
   (declare (ftype (function (integer integer) integer))
            (compiler-macro
             (lambda (form)