Skip to content
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

Some buildernames does not support caching #9359

Closed
marxin opened this issue Jun 17, 2021 · 4 comments · Fixed by #9360
Closed

Some buildernames does not support caching #9359

marxin opened this issue Jun 17, 2021 · 4 comments · Fixed by #9360

Comments

@marxin
Copy link
Contributor

marxin commented Jun 17, 2021

I noticed that e.g. HTML builder can cache output and does not generate anything if there's no change:

$ time make -j16 html
sphinx-build -b "html" -d _build/doctrees  -j auto  . "_build/html"
Running Sphinx v4.0.2
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 0 source files that are out of date
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
no targets are out of date.
build succeeded.

The HTML pages are in _build/html.

real	0m0.686s
user	0m0.610s
sys	0m0.076s

while e.g. manpages generation always writes:

$ time make -j16 man
sphinx-build -b "man" -d _build/doctrees  -j auto  . "_build/man"
Running Sphinx v4.0.2
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
writing... gcc.1 { gcc-command-options/description } done
build succeeded.

The manual pages are in _build/man.

real	0m5.142s
user	0m5.009s
sys	0m0.133s

As seen, looking for now-outdated files... none found is printed but output files are re-generated.

marxin added a commit to marxin/sphinx that referenced this issue Jun 17, 2021
marxin added a commit to marxin/sphinx that referenced this issue Jun 17, 2021
marxin added a commit to marxin/sphinx that referenced this issue Jun 17, 2021
@AA-Turner AA-Turner added this to the some future version milestone Sep 29, 2022
marxin added a commit to marxin/sphinx that referenced this issue Oct 3, 2022
marxin added a commit to marxin/sphinx that referenced this issue Oct 3, 2022
@AA-Turner
Copy link
Member

To confirm, this change makes it so that the man builder no longer unconditionally writes files?

A

@AA-Turner AA-Turner modified the milestones: some future version, 5.3.0 Oct 5, 2022
@marxin
Copy link
Contributor Author

marxin commented Oct 5, 2022

To confirm, this change makes it so that the man builder no longer unconditionally writes files?

Yes.

@floam
Copy link

floam commented Oct 28, 2022

Reopen?

@AA-Turner
Copy link
Member

Do you have a different proposed fix?

A

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Nov 28, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants