From 1643f70d3042ce01f716d8345fff8d6d7042fc9a Mon Sep 17 00:00:00 2001 From: Aaron Ecay Date: Sun, 27 May 2018 17:35:00 +0100 Subject: [PATCH] org-manual.org: Add a footnote about :file-ext As suggested by Alex Fenton in . --- doc/org-manual.org | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 707ca3224..9fba045d8 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -17175,7 +17175,7 @@ default behavior is to automatically determine the result type. If =file= is missing, Org generates the base name of the output file from the name of the code block, and its extension from the =file-ext= header argument. In that case, both the name and the - extension are mandatory. + extension are mandatory.[fn:150] #+begin_example ,#+name: circle @@ -21383,6 +21383,15 @@ on outline paths, assuming they are unique. =checksums.dat=. [fn:149] The file will be empty after this operation. + +[fn:150] Due to the way this header arg is implemented, it implies +“:results file”. Therefore if it is set for multiple blocks at once +(by a subtree or buffer property for example), all blocks will be forced +to produce file results. This is seldom desired behavior, so it is +recommended to set this header only on a per-block basis. It is possible +that this aspect of the implementation might change in the future. + + * Local variables :noexport: # Local Variables: -- 2.11.4.GIT