New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Sphinx: add --keep-going when fail_on_warning is true #7251
Conversation
The option was added in sphinx 1.8, and we only add it if the user sets `fail_on_warning: true`. https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-keep-going Closes #7240
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think usually we want -W and --keep-going together in the context of Read the Docs. So, I suppose it's fine.
@@ -240,7 +240,7 @@ def build(self): | |||
if self._force: | |||
build_command.append('-E') | |||
if self.config.sphinx.fail_on_warning: | |||
build_command.append('-W') | |||
build_command.extend(['-W', '--keep-going']) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do you think it's better to add them together here? Or it worth to have another config in our config file for the --keep-going
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't see a reason where users don't want these options together
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me!
I remember that we had some tests that checked how we called pip commands or similar. It may be good to have one for the Sphinx command as well eventually.
The option was added in sphinx 1.8,
and we only add it if the user sets
fail_on_warning: true
.https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-keep-going
Closes #7240