org: Installation
1.2 Installation
================
Org is part of recent distributions of GNU Emacs, so you normally don’t
need to install it. If, for one reason or another, you want to install
Org on top of this pre-packaged version, there are three ways to do it:
• By using Emacs package system.
• By downloading Org as an archive.
• By using Org’s git repository.
We strongly recommend to stick to a single installation method.
Using Emacs packaging system
............................
Recent Emacs distributions include a packaging system which lets you
install Elisp libraries. You can install Org with ‘M-x package-install
RET org’.
Important: you need to do this in a session where no ‘.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 ‘(package-initialize)’ in your
‘.emacs’ before setting any Org option. If you want to use Org’s
package repository, check out the Org ELPA page
(http://orgmode.org/elpa.html).
Downloading Org as an archive
.............................
You can download Org latest release from Org’s website
(http://orgmode.org/). In this case, make sure you set the load-path
correctly in your ‘.emacs’:
(add-to-list 'load-path "~/path/to/orgdir/lisp")
The downloaded archive contains contributed libraries that are not
included in Emacs. If you want to use them, add the ‘contrib’ directory
to your load-path:
(add-to-list 'load-path "~/path/to/orgdir/contrib/lisp" t)
Optionally, you can compile the files and/or install them in your
system. Run ‘make help’ to list compilation and installation options.
Using Org’s git repository
..........................
You can clone Org’s repository and install Org like this:
$ cd ~/src/
$ git clone git://orgmode.org/org-mode.git
$ make autoloads
Note that in this case, ‘make autoloads’ is mandatory: it defines
Org’s version in ‘org-version.el’ and Org’s autoloads in
‘org-loaddefs.el’.
Remember to add the correct load-path as described in the method
above.
You can also compile with ‘make’, generate the documentation with
‘make doc’, create a local configuration with ‘make config’ and install
Org with ‘make install’. Please run ‘make help’ to get the list of
compilation/installation options.
For more detailed explanations on Org’s build system, please check
the Org Build System page on Worg
(http://orgmode.org/worg/dev/org-build-system.html).