[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc strin
From: |
Eli Zaretskii |
Subject: |
Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string |
Date: |
Tue, 19 Jul 2022 18:54:08 +0300 |
> From: Mattias Engdegård <mattiase@acm.org>
> Date: Tue, 19 Jul 2022 17:08:48 +0200
> Cc: emacs-devel@gnu.org
>
> 19 juli 2022 kl. 16.26 skrev Eli Zaretskii <eliz@gnu.org>:
>
> > . 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?