Repository navigation
change log #29
Description
Activity
Though I haven't put together a proper changelog file yet, I really should get started on that.
A lot of the work of the 3.0 version has been to have the crate have less surprising behavior than it did before. For instance, the old
BitRead.readmethod could read both unsigned and signed types, but would read signed types as unsigned values and users would need to use theBitRead.read_signedmethod to handle them properly. This was a source of confusion. The new interface makes it impossible to make that mistake because the newBitRead.readmethod will always callread_unsignedorread_signedas appropriate based on the type.Similarly, promoting the
const-basedreadandwritemethods as the defaults and a new Huffman code handling interface catch more potential bugs at compile-time, which is a preferable to finding them at runtime. But I know it's troublesome to force people to upgrade lots of code at once, so my intent is to have theBitRead2andBitWrite2compatibility traits be as compatible with existing code as possible.Most of the remaining changes are overhauling the plumbing to make the crate a lot faster than before - ~50% faster in my tests - which will hopefully make it worth upgrading to.
I'll try to be more diligent in the future about documenting these things without users having to sort through commit logs.
Is there a change log somewhere? I don't see it in the two places I usually do:
CHANGELOG.mdwithin the repo, or via GitHub's releases feature.It's helpful to have a summary of what changed, particularly across version breaks like the recent v2 -> v3. I look there to see if there's any difference in semantics I might not notice (the code still compiles but changes meaning, or the "obvious" compile fix is wrong). And more mundane things like summaries of bugfixes and new features. I can go through commit-by-commit but that's a lot more work for all the users of the crate, and sometimes important things can be lost in the noise of private dependency updates, stylistic changes, etc.