8000 Unnecessary regeneration of API docs · Issue #394 · sphinx-gallery/sphinx-gallery · GitHub
[go: up one dir, main page]

Skip to content
Unnecessary regeneration of API docs #394
Closed
@jnothman

Description

@jnothman

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!

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      0