Pārlūkot izejas kodu

org-manual.org: Add a footnote about :file-ext

As suggested by Alex Fenton in
<https://lists.gnu.org/archive/cgi-bin/namazu.cgi?query=%2Bmessage-id%3A%3C6427e745-9ca4-2356-a262-ef257082a9ce%40pressure.to%3E&submit=Search&idxname=emacs-orgmode>.
Aaron Ecay 6 gadi atpakaļ
vecāks
revīzija
1643f70d30
1 mainītis faili ar 10 papildinājumiem un 1 dzēšanām
  1. 10 1
      doc/org-manual.org

+ 10 - 1
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
      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 from the name of the code block, and its extension from the
      =file-ext= header argument.  In that case, both the name and the
      =file-ext= header argument.  In that case, both the name and the
-     extension are mandatory.
+     extension are mandatory.[fn:150]
 
 
      #+begin_example
      #+begin_example
      ,#+name: circle
      ,#+name: circle
@@ -21383,6 +21383,15 @@ on outline paths, assuming they are unique.
 =checksums.dat=.
 =checksums.dat=.
 
 
 [fn:149] The file will be empty after this operation.
 [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                                                  :noexport:
 
 
 # Local Variables:
 # Local Variables: