better POD doc and examples, documenting the timeout option