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 17:08:48 +0200 Message-ID: References: <831quhnrf8.fsf@gnu.org> <063D21A9-801C-411B-B59C-AA7A057DFF79@acm.org> <83v8rtmb4r.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="8958"; 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 17:10:26 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 1oDorh-00029H-4O for ged-emacs-devel@m.gmane-mx.org; Tue, 19 Jul 2022 17:10:25 +0200 Original-Received: from localhost ([::1]:50572 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oDorg-0002sf-98 for ged-emacs-devel@m.gmane-mx.org; Tue, 19 Jul 2022 11:10:24 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40782) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDoqJ-00021h-C5 for emacs-devel@gnu.org; Tue, 19 Jul 2022 11:08:59 -0400 Original-Received: from mail1450c50.megamailservers.eu ([91.136.14.50]:37434 helo=mail265c50.megamailservers.eu) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDoqG-0007d7-M4; Tue, 19 Jul 2022 11:08:59 -0400 X-Authenticated-User: mattiase@bredband.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=megamailservers.eu; s=maildub; t=1658243331; bh=N8bmeQ79lSYX43AB5GtispFPgUxnjMpfp6u9f2Npmbw=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=VH+2uAr4SaWS1/fQJTbL/vgJjw6W3IbIIFQNUb7cXo0dkxhHhm2oh9rUpj5J/hPu7 xajJUDFV/I8wvtgqmpk9mVUw28S62XOQwTewxBIRxDWwAp49f6xVnfQWu3rJrWgFo6 G3Q+PgZ85rYIFESPqUBDaz4DEUWxuguPf4Kpo8zs= 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 mail265c50.megamailservers.eu (8.14.9/8.13.1) with ESMTP id 26JF8mq1116889; Tue, 19 Jul 2022 15:08:51 +0000 In-Reply-To: <83v8rtmb4r.fsf@gnu.org> X-Mailer: Apple Mail (2.3654.120.0.1.13) X-CTCH-RefID: str=0001.0A782F1F.62D6C903.001B, 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.50; envelope-from=mattiase@acm.org; helo=mail265c50.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:292273 Archived-At: 19 juli 2022 kl. 16.26 skrev Eli Zaretskii : > . it requires the reader to understand that shifting, multiplication, > and division are equivalent > . it requires the reader to understand the notion of "rounding down" You certainly don't think highly of elisp programmers... > How about explaining in simple words what this does to positive and > negative values shifted left and right? >=20 > One possible way to explain that is what the ELisp manual does. The manual uses the same definition as the doc string now uses. But let's try once more: Shifting left one step multiplies the value by two. Shifting right one step divides the value by two, after first = decrementing the value by one if it was odd.