ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/org-manual.org
View File

@ -19927,15 +19927,18 @@ changes.
#+cindex: @samp{SETUPFILE}, keyword #+cindex: @samp{SETUPFILE}, keyword
The setup file or a URL pointing to such file is for additional 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 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 specified, the contents are downloaded and stored in a temporary
file cache. {{{kbd(C-c C-c)}}} on the settings line parses and file cache. {{{kbd(C-c C-c)}}} on the settings line re-parses and
loads the file, and also resets the temporary file cache. Org also re-loads the file, and also resets the temporary file cache.
parses and loads the document during normal exporting process. Org
parses the contents of this document as if it was included in the Org also parses and loads /in-buffer settings/ from the setup file
buffer. It can be another Org file. To visit the file---not during normal exporting process. Org parses the /in-buffer
a URL---use {{{kbd(C-c ')}}} while point is on the line with the settings/ as if it was included in the containing Org buffer. The
file name. 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:= :: - =#+STARTUP:= ::