document timeouts better; fixes #4