Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string

[Eli Zaretskii]

> 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?