Anyone else seeing a lack of caching in local docs builds?
Hi folks, I'm currently seeing a behaviour where every time I run "make html", all 474 source files get rebuilt. For now, I'm assuming I've messed something up with my local docs build setup, but figured I'd ask if anyone else was seeing this, in case it was actually broken at the build level (CI wouldn't pick this up, since it always builds from scratch anyway). Cheers, Nick. -- Nick Coghlan | ncoghlan@gmail.com | Brisbane, Australia
On 1/27/2019 9:01 AM, Nick Coghlan wrote:
Hi folks,
I'm currently seeing a behaviour where every time I run "make html", all 474 source files get rebuilt.
I just rebuilt, ditto, all 474. Caching only works when I rebuild 'soon' (at least within same day) after a complete rebuild. I just updated and only function.rst was changed and only function.html and the indexes were rebuilt.
For now, I'm assuming I've messed something up with my local docs build setup, but figured I'd ask if anyone else was seeing this, in case it was actually broken at the build level (CI wouldn't pick this up, since it always builds from scratch anyway).
I think something is broken. Caching used to work better. -- Terry Jan Reedy
On Mon, 28 Jan 2019 at 05:44, Terry Reedy
On 1/27/2019 9:01 AM, Nick Coghlan wrote:
For now, I'm assuming I've messed something up with my local docs build setup, but figured I'd ask if anyone else was seeing this, in case it was actually broken at the build level (CI wouldn't pick this up, since it always builds from scratch anyway).
I think something is broken. Caching used to work better.
In my case, I had an older version of blurb installed, which was keeping NEWS from rendering properly, and I suspect that was preventing Sphinx from marking the cache as valid. I'm not sure about that theory though, as I would have expected an invalid NEWS file to only keep the NEWS file from being cached. Cheers, Nick. -- Nick Coghlan | ncoghlan@gmail.com | Brisbane, Australia
On Mon, 28 Jan 2019 18:02:16 +1000
Nick Coghlan
On Mon, 28 Jan 2019 at 05:44, Terry Reedy
wrote: On 1/27/2019 9:01 AM, Nick Coghlan wrote:
For now, I'm assuming I've messed something up with my local docs build setup, but figured I'd ask if anyone else was seeing this, in case it was actually broken at the build level (CI wouldn't pick this up, since it always builds from scratch anyway).
I think something is broken. Caching used to work better.
In my case, I had an older version of blurb installed, which was keeping NEWS from rendering properly, and I suspect that was preventing Sphinx from marking the cache as valid.
I'm not sure about that theory though, as I would have expected an invalid NEWS file to only keep the NEWS file from being cached.
I've often noticed oddities in Sphinx caching on other projects. I'm not sure the algorithm is extremely precise. Regards Antoine.
participants (3)
-
Antoine Pitrou
-
Nick Coghlan
-
Terry Reedy