[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Bug: code block not evaluated during export when placed in SETUPFILE
From: |
Ihor Radchenko |
Subject: |
Re: Bug: code block not evaluated during export when placed in SETUPFILE [9.4 (9.4-elpa @ /home/bruno/.emacs.d/elpa/org-9.4/)] |
Date: |
Sat, 18 Feb 2023 10:32:38 +0000 |
Bruno BEAUFILS <bruno.beaufils@univ-lille.fr> writes:
> In the org manual the following lines can be read about #+SETUPFILE:
> (emphaze is mine):
>
> » Org also parses and loads the document during normal exporting process.
> » Org parses the contents of this document **as if it was included** in the
> » buffer. It can be **another Org file**.
#+SETUPFILE is only parsed for export settings. It is not actually
included. I admit that the wording may be confusing.
To actually include the document, use #+INCLUDE.
I tried to clarify the manual section in the attached patch.
>From 64cc230e39378d7c1fee4954f415358ae8055c4f Mon Sep 17 00:00:00 2001
Message-Id:
<64cc230e39378d7c1fee4954f415358ae8055c4f.1676716311.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Sat, 18 Feb 2023 13:30:39 +0300
Subject: [PATCH] org-manual.org: Clarify what SETUPFILE does
* doc/org-manual.org (Summary of In-Buffer Settings): Clarify that
only in-buffer settings are considered in SETUPFILE. Other contents
is ignored. Split the explanation into multiple paragraphs.
Reported-by: Bruno BEAUFILS <bruno.beaufils@univ-lille.fr>
Link: https://orgmode.org/list/20230216235224.7g5xdlkcnw2z4k3n@settat
---
doc/org-manual.org | 19 +++++++++++--------
1 file changed, 11 insertions(+), 8 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index 5b6633417..60c062921 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -19922,15 +19922,18 @@ ** Summary of In-Buffer Settings
#+cindex: @samp{SETUPFILE}, keyword
The setup file or a URL pointing to such file is for additional
in-buffer settings. Org loads this file and parses it for any
- settings in it only when Org opens the main file. If URL is
+ settings in it when Org opens the main file. If URL is
specified, the contents are downloaded and stored in a temporary
- file cache. {{{kbd(C-c C-c)}}} on the settings line parses and
- loads the file, and also resets the temporary file cache. Org also
- parses and loads the document during normal exporting process. Org
- parses the contents of this document as if it was included in the
- buffer. It can be another Org file. To visit the file---not
- a URL---use {{{kbd(C-c ')}}} while point is on the line with the
- file name.
+ file cache. {{{kbd(C-c C-c)}}} on the settings line re-parses and
+ re-loads the file, and also resets the temporary file cache.
+
+ Org also parses and loads /in-buffer settings/ from the setup file
+ during normal exporting process. Org parses the /in-buffer
+ settings/ as if it was included in the containing Org buffer. The
+ rest of the contents of setup file is ignored.
+
+ To visit the setup file---not a URL---use {{{kbd(C-c ')}}} while point
+ is on the line with the setup file name.
- =#+STARTUP:= ::
--
2.39.1
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>