summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBastien Guerry <bzg@altern.org>2014-04-17 13:38:29 +0200
committerBastien Guerry <bzg@altern.org>2014-04-17 13:38:29 +0200
commit4315658419ebd22a0b54878029824c3adbe9d510 (patch)
treee89bd7f4934a0aa819f39a86ac7f5ff400c0cb07
parenta937366e8ae306ed5ff7bed31fd1d0d54bc8d5de (diff)
downloadorg-mode-4315658419ebd22a0b54878029824c3adbe9d510.tar.gz
org.texi (Installation): Fix documentation bug
* org.texi (Installation): Be more clear on why installing Org through ELPA should be done without loading any Org file. This is a very common pitfall that needs to be considered a documentation bug.
-rw-r--r--doc/org.texi6
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/org.texi b/doc/org.texi
index c1a19ed..115da51 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -878,7 +878,11 @@ We @b{strongly recommend} to stick to a single installation method.
Recent Emacs distributions include a packaging system which lets you install
Elisp libraries. You can install Org with @kbd{M-x package-install RET org}.
-You need to do this in a session where no @code{.org} file has been visited.
+
+@noindent @b{Important}: you need to do this in a session where no @code{.org} file has
+been visited, i.e. where no Org built-in function have been loaded.
+Otherwise autoload Org functions will mess up the installation.
+
Then, to make sure your Org configuration is taken into account, initialize
the package system with @code{(package-initialize)} in your @file{.emacs}
before setting any Org option. If you want to use Org's package repository,