cleanup code docs making them all doxygen capable

[JeffGarland]

There's a lot of documentation in scope.hpp that needs work. It should be doxygen ready like the scope_guard case so it can feed into doc generation tooling.

This is a decent first issue since it doesn't involve writing code :)