pass by reference/doxygen comments.