Updating libreddit in-code documentation

This commit cleans up the comments in libreddit, to reflect all the
changes that it has gone through and make sure no comments were stale.