Improved agent class doc comments a lot
fixed begincode->code doxygen errors
Merge pull request #949 from rwcarlsen/devdoc

improve agent class doc comments