document new "retryable" flag