Use post for oauth token requests

- This forces the API into standards compliant form encoded parameter
responses.
- Remove Xml response demangling code.
- Tidy up oauth helper library
Tidy and better document OAuth example
Update docs to relect OAuth improvements

- Tighten up lanugage.
- Reorganise secions to more logical order.
- Remove warnigns about having to use the OAuth helper.