Skip to content

Commit

Permalink
org-manual: Document `org-babel-default-inline-header-args'
Browse files Browse the repository at this point in the history
* 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.
  • Loading branch information
yantar92 committed Aug 22, 2022
1 parent 8d93f9b commit 1b5ccb1
Showing 1 changed file with 23 additions and 0 deletions.
23 changes: 23 additions & 0 deletions doc/org-manual.org
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down

0 comments on commit 1b5ccb1

Please sign in to comment.