[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
Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string
Tue, 19 Jul 2022 18:54:08 +0300
> From: Mattias Engdegård <email@example.com>
> Date: Tue, 19 Jul 2022 17:08:48 +0200
> Cc: firstname.lastname@example.org
> 19 juli 2022 kl. 16.26 skrev Eli Zaretskii <email@example.com>:
> > . 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.
Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string, Stefan Monnier, 2022/07/19