Improve the description of #+SETUPFILE and #+INCLUDE
authorCarsten Dominik <carsten.dominik@gmail.com>
Mon, 25 Mar 2013 09:53:32 +0000 (10:53 +0100)
committerCarsten Dominik <carsten.dominik@gmail.com>
Mon, 25 Mar 2013 09:53:32 +0000 (10:53 +0100)
org-8.0.org

index 1e0056c..346796a 100644 (file)
@@ -118,11 +118,15 @@ If something does not work, please report it on the mailing list.
 
 1. =#+STYLE:= -> =#+HTML_HEAD:=
 
-2. =#+SETUPFILE: myfile= -> =#+INCLUDE: "myfile"=
-
-   Quotes are required and =#+INCLUDE= works a little differently
-   than #+setupfile: by default, it makes sure that every headline in the
-   included file will be a child of the headline containing the include
+2. =#+SETUPFILE: myfile= versus =#+INCLUDE: "myfile".=
+
+   Both =#+SETUPFILE:= and =#+INCLUDE:= now need quotes around the
+   file name.  There is now also a clear difference between these two
+   statements.  The first will only read keyword statements like
+   =#+TODO:= and use this to set up the current file.  Thesecond will
+   pull in the entire content of the file during export.  The
+   =#+INCLUDE:= statement will make every headline in the included
+   file will be a child of the headline containing the include
    keyword.  You can overwrite this behaviour with =:minlevel= num
    parameter.