Cleanup

Removes two c++ warnings. Improves documentation.
Obviously it doesn't matter which doc style you use, I just wanted to say that I actually prefer the ```/** comment */``` style because it makes the source code look less crowded. ```///``` is okay for short (one-line) comments but imo looks weird in multi-line. Just my 2¢  ....