I've added some javadoc comments.  

I've been unable to verify that timeout actually does anything helpful and have documented it as such in the wiki.