From 64cc230e39378d7c1fee4954f415358ae8055c4f Mon Sep 17 00:00:00 2001 Message-Id: <64cc230e39378d7c1fee4954f415358ae8055c4f.1676716311.git.yantar92@posteo.net> From: Ihor Radchenko 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 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