improved mainly documentation

* improved description of get-method
* changed $self->{expires} = time + 10 * 60 to $self->{reqtime} = time
* expanded API section/example
* little prototype fix (new-method)