Few documentation additions to player.h

This is nothing major. It's supposed to start a chain of additions I want to provide for Trinity for the doxygen documentation. Additions can be challenged of course and can be fit according to suggestions or critic.