From 1b5ccb10971f67c7f80052ddb32b5e5cf2dba71d Mon Sep 17 00:00:00 2001 From: Ihor Radchenko Date: Wed, 20 Jul 2022 20:03:37 +0800 Subject: [PATCH] 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. --- doc/org-manual.org | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/org-manual.org b/doc/org-manual.org index 56ee87ca1..d3331861e 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -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.