[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/org 1b5ccb1097 1/4: org-manual: Document `org-babel-def
From: |
ELPA Syncer |
Subject: |
[elpa] externals/org 1b5ccb1097 1/4: org-manual: Document `org-babel-default-inline-header-args' |
Date: |
Mon, 22 Aug 2022 08:57:53 -0400 (EDT) |
branch: externals/org
commit 1b5ccb10971f67c7f80052ddb32b5e5cf2dba71d
Author: Ihor Radchenko <yantar92@gmail.com>
Commit: Ihor Radchenko <yantar92@gmail.com>
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 56ee87ca1d..d3331861e8 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.