added documentation and missing getters/setters
user_list post uses new user model api
moved userlist logic into the list() method of the user model
made auth token useage more intuitive
removed depriciated verification function that returned an instance of user instead of verifying for the current instance.
Merge pull request #4 from dan-hill/user-model-cleanup

User model cleanup
Merge pull request #5 from dan-hill/master

Pull changes into the feature cleanup branch.