Doc/code comments

I spent some time going through hummingbird.js trying to understand how it worked and documenting that understanding as I went along.

I don't know whether my comments are correct so they could do with a review before merging!