From: Stefan Kangas <stefankangas@gmail.com>
Date: Sat, 22 Feb 2025 17:15:37 +0000 (+0100)
Subject: Improve wording of lsh docstring
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a131007e29305834316b613b7ac096dcbd444fac;p=emacs.git

Improve wording of lsh docstring

* lisp/subr.el (lsh): Improve wording of docstring.

(cherry picked from commit e15dcb2db5c40e90ea2a21391af5addb9e778779)
---

diff --git a/lisp/subr.el b/lisp/subr.el
index 93e7e20dc5e..6b08a36c713 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -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)