Change sizes to Long and fix a few doc comments

Changes to match scodec-bits
scodec-core 1.3.0 will be released much sooner than scodec-bits 1.1.0. However, the rest of this PR works with 1.0.2 I believe. Can you edit the commit and put this back to 1.0.2 for now? Thanks for all the doc fixes too!