tweak retry params, improve javadoc

- thanks to Kevin Hollingshead