in all doxygen comments, you have to provide @param for all parameters, otherwise we will get warnings later. Also makes sense :)