Task: Document that retry(max_retries=None) means "use the default".  Closes #1875