add a bunch of badly written comments

I'm sorry in advance for those comments, it was late and I had to write them
at some point in time to finish the first release...