Closed
Description
The creation of .examples
files for backreferences from API documentation always leaves those .examples
newly modified, even if the underlying examples were unchanged. This results in the API doc being re-generated as well (i.e. they are marked as changed in Sphinx's "updating environments" log item).
Ideally, we should have a way to identify unchanged examples backrefs, and make sure their mtimes are unchanged. One way may be to write to a temporary file and only overwrite if changed, after all examples are run.
But I remember implementing the backrefs .examples
files was a bit of a hack, so I'm not sure how easy it is to hack it further!