Doxygen comment fixes

In particular:

> warning: unable to resolve reference to `std::istream' for \ref command
Doxygen comment fixes

In particular:

> warning: unable to resolve reference to `std::istream' for \ref command