From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string Date: Tue, 19 Jul 2022 18:54:08 +0300 Message-ID: <83r12hm733.fsf@gnu.org> References: <831quhnrf8.fsf@gnu.org> <063D21A9-801C-411B-B59C-AA7A057DFF79@acm.org> <83v8rtmb4r.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="7161"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Mattias =?utf-8?Q?Engdeg=C3=A5rd?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jul 19 17:55:20 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 1oDpZ9-0001h9-4t for ged-emacs-devel@m.gmane-mx.org; Tue, 19 Jul 2022 17:55:19 +0200 Original-Received: from localhost ([::1]:48128 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oDpZ7-0000Ct-Ji for ged-emacs-devel@m.gmane-mx.org; Tue, 19 Jul 2022 11:55:17 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55766) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDpYC-0007vG-CX for emacs-devel@gnu.org; Tue, 19 Jul 2022 11:54:20 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:37330) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDpYC-0008Oa-4P; Tue, 19 Jul 2022 11:54:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=3IVN4JQz0MlHDzikxWgn7Oqgg8g4IKWM8g4UP1gAl74=; b=BwD8FvU+Mft0sg/1N667 UEUH8fdf/dNne82PCuWBy3+kJU4mtYqPDl2SQeOpPGdXdxSca+nogeVARMj4dz4UF7s3kxr2xtD4U UAfAdZT5Jrzk57kzOBH/+Cs6a7dH0u4I4GyNrAGcdoAFCnWVzLUKr9z+eOUNhuTXKPAQDXnnR476z DxwZDAu2hWXb77do2zt4vcGOpvh6NOW2u2z+vY/vF8KXVzprncAfXgg0EhfLyy6/ml6CmevdqmZ2o EAarY2YfkI40GwYe516Z/8c24Vv/8zKHSrg2yQ6hamQ1rQlgzCcdA9qVoTR9cheNI8alZNWACLBXR fAVnMWlZKOh74Q==; Original-Received: from [87.69.77.57] (port=4448 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDpYB-0001cL-Kr; Tue, 19 Jul 2022 11:54:19 -0400 In-Reply-To: (message from Mattias =?utf-8?Q?Engdeg=C3=A5rd?= on Tue, 19 Jul 2022 17:08:48 +0200) 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:292278 Archived-At: > From: Mattias Engdegård > Date: Tue, 19 Jul 2022 17:08:48 +0200 > Cc: emacs-devel@gnu.org > > 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... That's besides the point. Clear documentation should be understandable by everyone. > 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. Still not there, sorry. It is okay to say that shifting is the same as multiplying or dividing, but why say _only_ that? The operation is "bit shift", so the most natural way of describing it is in terms of shifting bits. No?