Add thrown exceptions in documentation

[yvele]

Can you improve the documentation and add what exceptions are thrown and why? For example if you use get with a non existing reference token, the function will throw an Error the a message saying "Invalid reference token: foo".

It's too bad I have to browse the code or the unit tests to figure out what is the basic behavior of the functions.