From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?Q?Mattias_Engdeg=C3=A5rd?= Newsgroups: gmane.emacs.devel Subject: Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string Date: Tue, 19 Jul 2022 16:19:52 +0200 Message-ID: <063D21A9-801C-411B-B59C-AA7A057DFF79@acm.org> References: <831quhnrf8.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14476"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jul 19 16:34:03 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oDoIU-0003ae-By for ged-emacs-devel@m.gmane-mx.org; Tue, 19 Jul 2022 16:34:02 +0200 Original-Received: from localhost ([::1]:35600 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oDoIT-0004zg-8z for ged-emacs-devel@m.gmane-mx.org; Tue, 19 Jul 2022 10:34:01 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56718) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDo4x-0004pQ-JG for emacs-devel@gnu.org; Tue, 19 Jul 2022 10:20:05 -0400 Original-Received: from mail1455c50.megamailservers.eu ([91.136.14.55]:44544 helo=mail266c50.megamailservers.eu) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDo4u-0007KO-4N; Tue, 19 Jul 2022 10:20:03 -0400 X-Authenticated-User: mattiase@bredband.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=megamailservers.eu; s=maildub; t=1658240395; bh=KGwHfvgnnWXJ8tpDMF42j2j7VwJLvZ8vdmem9lKpulo=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=c6b/tYb+wV8JqASdjtqyuoi+7P/4lWkT88POFnnPf8bFBXxcDgOodcAx8PF4/DYTt ESJdGXiFuHgKLqdFVM7NCOO6ehUT0qF/LOEE4W1P/rCax72LOKEsg4VNWIi0o3Eug2 jU7kthO7ajKHb2s7yPO0XImR9qvRfP1XxKnmU6Dk= Feedback-ID: mattiase@acm.or Original-Received: from smtpclient.apple (c188-150.188-179.bredband.tele2.se [188.150.188.179] (may be forged)) (authenticated bits=0) by mail266c50.megamailservers.eu (8.14.9/8.13.1) with ESMTP id 26JEJrqH037299; Tue, 19 Jul 2022 14:19:55 +0000 In-Reply-To: <831quhnrf8.fsf@gnu.org> X-Mailer: Apple Mail (2.3654.120.0.1.13) X-CTCH-RefID: str=0001.0A782F22.62D6BD8B.007D, ss=1, re=0.000, recu=0.000, reip=0.000, cl=1, cld=1, fgs=0 X-CTCH-VOD: Unknown X-CTCH-Spam: Unknown X-CTCH-Score: 0.000 X-CTCH-Flags: 0 X-CTCH-ScoreCust: 0.000 X-Origin-Country: SE Received-SPF: softfail client-ip=91.136.14.55; envelope-from=mattiase@acm.org; helo=mail266c50.megamailservers.eu X-Spam_score_int: -11 X-Spam_score: -1.2 X-Spam_bar: - X-Spam_report: (-1.2 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, SPF_HELO_NONE=0.001, SPF_SOFTFAIL=0.665, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:292269 Archived-At: 19 juli 2022 kl. 15.49 skrev Eli Zaretskii : > I'm afraid I find the modified doc string less self-explanatory wrt > what happens when VALUE is negative. It might be more accurate, but > makes it harder to understand what happens in that case. The old text was definitely not self-explanatory; it made me more = confused than enlightened. But let's try again. What about: Return VALUE with its bits shifted left by COUNT. If COUNT is negative, shifting is actually to the right. Values are shifted as an infinitely wide two's complement = representation; each shift step multiplies (left-shifting) or divides = (right-shifting) the value by two, rounding down. VALUE and COUNT must be integers.