added forcenew tag to force obtaining a new token
fixed some error messages.
improved documentation