Update Javadoc for pause/resume

Fixes #2518