Doxygen: Fixed some warnings due to incorrect/missing comments.

There are two warnings on the parameter 'tolerance' left.
Further discussion needed on how to deal with this before fixing it.