WIP: Updating and reformatting existing docstrings.

[dennorske]

Also adding new docstrings. Updated two methods in Player module with breaking changes

Breaking Changes:

1. Player.get_target_player: Returns a Player object if the player is targeting another player. Returns None otherwise. Before, this was returning an integer which represented the playerid.
2. Player.get_target_actor: Returns an Actor object if the player is targeting an actor. Returns None otherwise. Before, this was returning an integer.