[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: |
Mattias Engdegård |
Subject: |
Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string |
Date: |
Tue, 19 Jul 2022 16:19:52 +0200 |
19 juli 2022 kl. 15.49 skrev Eli Zaretskii <eliz@gnu.org>:
> I'm afraid I find the modified doc string less self-explanatory wrt
> what happens when VALUE is negative. It might be more accurate, but
> makes it harder to understand what happens in that case.
The old text was definitely not self-explanatory; it made me more confused than
enlightened.
But let's try again. What about:
Return VALUE with its bits shifted left by COUNT.
If COUNT is negative, shifting is actually to the right.
Values are shifted as an infinitely wide two's complement representation; each
shift step multiplies (left-shifting) or divides (right-shifting) the value by
two, rounding down.
VALUE and COUNT must be integers.
Re: master ac1d15e95c 1/2: ; * src/data.c (Fash): More precise doc string, Stefan Monnier, 2022/07/19