Tim Landscheidt <t...@tim-landscheidt.de> writes: > But why did I spend a few hours debugging this before final- > ly understanding Org's mode of operation? The first sen- > tence of the documentation in "13.4 Include Files" reads: > > | During export, you can include the content of another file. > | […] > > I'm not a native speaker, but the word "during" drew the > mental image for me that, when exporting, Org starts at the > top of the document, reads through to the end, and if en- > counters a "#+INCLUDE:" statement /during/ that, it includes > the referenced file at that point. > > Now the Org manual is already beset with examples that look > as if someone complained about something not being document- > ed somewhere, and then someone adding one sentence just that > somewhere, so I don't want to add to that with "just a quick > fix". > > But I do think it would be helpful if the "order" while ex- > porting would be documented in a meaningful way.
Sure. We can add a section summarizing the export process at the end of "13 Exporting". Patches welcome! The export sequence is implemented in `org-export-as'. -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92> Confirmed.