org-manual: Document `org-babel-default-inline-header-args'

* doc/org-manual.org (System-wide header arguments): Update the
default value of `org-babel-default-header-args'.  Document that
inline source blocks use a different set of the default arguments.
This commit is contained in:
Ihor Radchenko 2022-07-20 20:03:37 +08:00
parent 8d93f9b6b4
commit 1b5ccb1097
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 23 additions and 0 deletions

View File

@ -17147,8 +17147,31 @@ following values:
:exports => "code"
:cache => "no"
:noweb => "no"
:hlines => "no"
:tangle => "no"
#+end_example
#+vindex: org-babel-default-inline-header-args
Inline source blocks (see [[*Structure of Code Blocks]]) use slightly
different default header arguments defined in
~org-babel-default-inline-header-args~:
#+begin_example
:session => "none"
:results => "replace"
:exports => "results"
:hlines => "yes"
#+end_example
The most notable difference between default header arguments for
inline and normal source blocks is =:exports= argument. For inline
source blocks, results of evaluation are exported by default; not the
code.
Unlike the default values, header arguments set using Org mode
properties (see [[*Header arguments in Org mode properties]]) do apply to
both the normal source blocks and inline source blocks.
The example below sets =:noweb= header arguments to =yes=, which makes
Org expand =:noweb= references by default.