add some documentation

some documentation (in particular with `@raise` for `Re.exec`) and a simple example.