Added lots of comments

I have added a bunch of documentation in openscad_docsgen format.

I also spotted and fixed an error in unrotate(), but this function isn't actually used anywayere...

At some point we should actually build these docs and make them visible - but for now I think even just the comments are helpful.