more docs
add DEBUG flag for dis/enabling debug output via conditial compilation

removed debug output in YieldSize.hs as it causes side-effects due to
the yieldSize combinator