From 5105b99754cf65326a34241d4f4f09bc01f630d4 Mon Sep 17 00:00:00 2001
From: Fabien Dubosson <fabien.dubosson@gmail.com>
Date: Mon, 12 Oct 2015 22:48:47 +0200
Subject: [PATCH] Add a note about org loading limitation

Add a release note about the limitation of org loading since 0.105, and
also document it in the org-layer's README.

Close #3277

Move note to FAQ and correct text to 0.104
---
 doc/FAQ.org           |  7 +++++++
 layers/org/README.org | 12 +++++++-----
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/doc/FAQ.org b/doc/FAQ.org
index 1c2fa38f1..9bd1bb1ca 100644
--- a/doc/FAQ.org
+++ b/doc/FAQ.org
@@ -8,6 +8,7 @@
      - [[#the-powerline-separators-have-no-anti-aliasing-what-can-i-do-][The powerline separators have no anti-aliasing, what can I do ?]]
      - [[#why-is-after-init-hook-not-executed-][Why is after-init-hook not executed ?]]
      - [[#what-is-the-difference-between-spacemacs-base-and-spacemacs-distributions-][What is the difference between =spacemacs-base= and =spacemacs= distributions ?]]
+     - [[#why-do-some-of-my-org-related-settings-cause-problems][Why do some of my =org=-related settings cause problems?]]
    - [[#windows][Windows]]
      - [[#why-do-the-fonts-look-crappy-on-windows-][Why do the fonts look crappy on Windows ?]]
      - [[#why-is-there-no-spacemacs-logo-in-the-startup-buffer-][Why is there no Spacemacs logo in the startup buffer ?]]
@@ -56,6 +57,12 @@ passed =-l init.el= file.
  check out the =packages.el= file in the respective folders in the
  =+distribution= folder of the =layers/= directory.
 
+*** Why do some of my =org=-related settings cause problems?
+Since version 0.104, spacemacs uses the `org` version from the org ELPA
+repository instead of the one shipped with emacs. Then, any `org` related code
+should not be loaded before `dotspacemacs/user-config`, otherwise both versions
+will be loaded and will conflict.
+
 ** Windows
 *** Why do the fonts look crappy on Windows ?
 You can install [[https://code.google.com/p/mactype/][MacType]] on Windows to get very nice looking fonts. It is
diff --git a/layers/org/README.org b/layers/org/README.org
index eee4cde58..78d6d80fa 100644
--- a/layers/org/README.org
+++ b/layers/org/README.org
@@ -5,6 +5,7 @@
 * Table of Contents                                                   :TOC@4:
  - [[#description][Description]]
    - [[#features][Features:]]
+   - [[#note][Note]]
  - [[#install][Install]]
    - [[#layer][Layer]]
    - [[#github-support][Github support]]
@@ -34,11 +35,15 @@ This layer enables  [[http://orgmode.org/][org mode]] for Spacemacs.
 - A [[http://pomodorotechnique.com/][pomodoro method]] integration via [[https://github.com/lolownia/org-pomodoro][org-pomodoro]]
 - TODO capture via [[https://github.com/waymondo/org-repo-todo][org-repo-todo]]
 - presentation mode via [[https://github.com/rlister/org-present][org-present]]
+- 
+** Note
+Since version 0.104, spacemacs uses the `org` version from the org ELPA
+repository instead of the one shipped with emacs. Then, any `org` related code
+should not be loaded before `dotspacemacs/user-config`, otherwise both versions
+will be loaded and will conflict.
 
 * Install
-
 ** Layer
-
 To use this contribution add it to your =~/.spacemacs=
 
 #+BEGIN_SRC emacs-lisp
@@ -46,7 +51,6 @@ To use this contribution add it to your =~/.spacemacs=
 #+END_SRC
 
 ** Github support
-
 To install Github related extensions like [[https://github.com/larstvei/ox-gfm][ox-gfm]] to export to Github
 flavored markdown set the variable =org-enable-github-support= to =t=.
 
@@ -57,7 +61,6 @@ flavored markdown set the variable =org-enable-github-support= to =t=.
 #+END_SRC
 
 ** Gnuplot support
-
 Org-mode support the plotting of data within tables through [[http://www.gnuplot.info/][Gnuplot]] as
 demonstrated [[http://orgmode.org/worg/org-tutorials/org-plot.html][here]]; unfortunately, this is [[https://github.com/bruceravel/gnuplot-mode/issues/15][not terribly well supported]] on Windows
 at this stage.  It is possible to disable the configuration of gnuplot support
@@ -65,7 +68,6 @@ as usual by adding the package =gnuplot= to your =dotspacemacs-excluded-packages
 variable.
 
 ** Different bullets
-
 You can tweak the bullets displayed in the org buffer in the function
 =dotspacemacs/user-config= of your dotfile by setting the variable
 =org-bullets-bullet-list=. By default the list is set to =("◉" "○" "✸" "✿")=.