org-8.0: Fix #+toc description, add export snippets
authorNicolas Goaziou <n.goaziou@gmail.com>
Wed, 27 Mar 2013 17:01:57 +0000 (18:01 +0100)
committerNicolas Goaziou <n.goaziou@gmail.com>
Wed, 27 Mar 2013 17:01:57 +0000 (18:01 +0100)
org-8.0.org

index 346796a..eeb6a09 100644 (file)
@@ -54,21 +54,33 @@ the manual, please report it to the list.
 
 ** New #+TOC keyword
 
-There is a new =#+TOC= which allow adding more "table of contents" for the
-LaTeX backend (for now).
+There is a new =#+TOC= which allows adding table of contents, lists of
+tables and lists of listings at specific locations during export.
 
 #+BEGIN_SRC org
   ,#+TOC: headlines 2
-  ,#+TOC: figures
   ,#+TOC: tables
   ,#+TOC: listings
 #+END_SRC
 
-This will add the corresponding tables of contents.
-For now, the ODT backend only supports "headlines"
-
 See the "Table of contents" section in the manual.
 
+* New syntax
+
+** Export snippets
+
+   Export snippets are a generalization of ~@<tag>~ concept, which has
+   been removed, and the inline version of
+   ~#+begin_backend...#+end_backend~ blocks.
+
+   Their syntax is ~@@backend:value~ where ~backend~ is the targetted
+   export backend (e.g. ~html~) and ~value~ can contain anything but
+   ~@@~.
+
+   When export is done with ~backend~, the snippet is replaced with
+   ~value~, otherwise it is removed.  Whitespace characters around
+   the construct are never deleted.
+
 * Updating backend-specific configuration options
 
 Backend-specific options are defined like this:
@@ -123,7 +135,7 @@ If something does not work, please report it on the mailing list.
    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
+   =#+TODO:= and use this to set up the current file.  The second 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