AthContainers: Update/fix the Accessor documentation.

Update some of the documentation for the Accessor classes to better agree with current practices, and fix some inconsistencies.