doxygen comments and a partial update sampler fix