doc/org-manual.org: Deprecate installation thru Org ELPA or archives

* doc/org-manual.org (Installation): Do not document installation
through Org ELPA or an archive as these installation methods will
become obsolete after Org 9.5.
This commit is contained in:
Bastien Guerry 2021-04-28 09:39:18 +02:00
parent 047fa8c319
commit f9cdda8234
2 changed files with 21 additions and 31 deletions

View File

@ -82,11 +82,8 @@ probably do not need to install it. Most users will simply activate
Org and begin exploring its many features.
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 the Emacs package system;
- by downloading Org as an archive; or
- by using Org's git repository.
pre-packaged version, you can use the Emacs package system or clone
Org's git repository.
We *strongly recommend* sticking to a single installation method.
@ -106,32 +103,6 @@ visited, i.e., where no Org built-in function have been loaded.
Otherwise autoload Org functions will mess up the installation.
#+end_quote
If you want to use Org's package repository, check out the [[https://orgmode.org/elpa.html][Org ELPA
page]].
*** Downloading Org as an archive
:PROPERTIES:
:UNNUMBERED: notoc
:END:
You can download Org latest release from [[https://orgmode.org/][Org's website]]. In this case,
make sure you set the load path correctly in your Emacs init file:
#+begin_src emacs-lisp
(add-to-list 'load-path "~/path/to/orgdir/lisp")
#+end_src
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:
#+begin_src emacs-lisp
(add-to-list 'load-path "~/path/to/orgdir/contrib/lisp" t)
#+end_src
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
:PROPERTIES:
:UNNUMBERED: notoc

View File

@ -11,6 +11,25 @@ See the end of the file for license conditions.
Please send Org bug reports to mailto:emacs-orgmode@gnu.org.
* Version 9.5 (not yet released)
** Important announcements
*** Org ELPA and Org archives won't be available for Org > 9.5
[[https://orgmode.org/elpa.html][Org ELPA]] is still available for installing Org 9.5, either with or
without contributed packages, but future versions won't be available
via Org ELPA, as we are deprecating this installation method.
Also, Org 9.5 is available as =tar.gz= and =zip= archives, but this
installation method is also deprecated.
If you want to install the latest stable versions of Org, please use
the GNU ELPA package. If you want to install the contributed files,
please use the NonGNU ELPA package. If you want to keep up with the
latest unstable Org, please install from the Git repository.
See https://orgmode.org/org.html#Installation for the details.
** New options and settings
*** Option ~org-hidden-keywords~ now also applies to #+SUBTITLE: