Quick notes on switching to the new exporter

diff --git a/org-faq.org b/org-faq.org
index f6e8bee..9df7818 100644 (file)
--- a/org-faq.org
+++ b/org-faq.org
@@ -307,6 +307,29 @@ about the number of list readers.
   :PROPERTIES:
   :CUSTOM_ID: Keeping-current
   :END:
+** Switching to the new export engine
+   :PROPERTIES:
+   :CUSTOM_ID: new-exporter-switch
+   :END:
+
+#+index: Upgrade
+
+Some quick notes on how to switch to the new exporter.
+
+1. Export engine renamed: org-export → ox
+2. Backend requires renamed: org-e-* → ox-*
+3. All backend specific variables and functions renamed:
+   - org-export-* → org-* (e.g. org-html-xml-declaration, ..)
+   - org-e-* → org-* (e.g. org-latex-classes, org-ascii-bullets, ..)
+4. Generic export variables retain the name org-export-*
+   (e.g. org-export-dispatch-use-expert-ui,
+   org-export-filter-headline-functions, ..)
+5. org-latex-to-pdf-process has been renamed to org-latex-pdf-process
+7. This is a guess, export snippets and backend symbols renamed:
+   - e-<backend> → <backend>
+
+Please also read [[http://mid.gmane.org/876229nrxf.fsf@gmail.com][Nicolas' announcement]] about the merge.
+
 ** My Emacs ships with an older version Org-mode! How do I upgrade?
    :PROPERTIES:
    :CUSTOM_ID: updating-org