From 5c744d834259d4144e779a79eaf0c9e312e75ed6 Mon Sep 17 00:00:00 2001 From: Chris Sewell Date: Thu, 20 Aug 2020 22:37:37 +0100 Subject: =?UTF-8?q?=F0=9F=93=9A=20DOCS:=20Improve=20build=20process=20over?= =?UTF-8?q?view?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/extdev/appapi.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/extdev/appapi.rst b/doc/extdev/appapi.rst index 036b57ec1..9a29aa77f 100644 --- a/doc/extdev/appapi.rst +++ b/doc/extdev/appapi.rst @@ -179,8 +179,10 @@ type for that event:: 11. event.env-get-updated(app, env) 11. event.env-check-consistency(app, env) + # The updated-docs list can be builder dependent, but generally includes all new/changed documents, + # plus any output from `env-get-updated`, and then all "parent" documents in the ToC tree # For builders that output a single page, they are first joined into a single doctree before post-transforms/doctree-resolved - for docname in docnames: + for docname in updated-docs: 12. apply post-transforms (by priority): docutils.document -> docutils.document 13. event.doctree-resolved(app, doctree, docname) - (for any reference node that fails to resolve) event.missing-reference(env, node, contnode) -- cgit v1.2.1