Document transducers that use mutable objects

This is a first attempt to fix #139. Unfortunately I wasn't able to use one `@define` macro for both files, `compress.scala` and `hash.scala`.