also, use withers instead of setters, and update docs
The documentation is generated using doxygen (http://www.doxygen.org).