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
This commit is contained in:
Ihor Radchenko 2023-02-18 13:30:39 +03:00
parent e46811c5e1
commit 15e70240e9
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 11 additions and 8 deletions

View File

@ -19927,15 +19927,18 @@ changes.
#+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:= ::