Updated doxygen api comments.
Merge pull request #1328 from seanpaultaylor/next

Updated doxygen api comments.