Vid 1582

The following is a bit of indulgence on my part, updating the docs to be in a valid doxygen format.