* Documentation suggestion: Mention async-bytecomp-package-mode in the installation section of the manual
@ 2020-10-27 2:32 Gustavo Barros
0 siblings, 0 replies; only message in thread
From: Gustavo Barros @ 2020-10-27 2:32 UTC (permalink / raw)
I've seen time and again folks get bitten by trying to install Org with
`package.el' while having Org loaded. The latest, but certainly not the
first and not the last:
This is well known, and indeed the manual states "important" in bold to
say that "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."
But it is not always easy to ensure that, even when you know what you
are doing. And certainly not trivial to users less acquainted with the
package system and how library loading works, etc.
However, there is a very easy way to ensure that
installation/byte-compilation is done in a clean environment in package
`async', namely `async-bytecomp-package-mode'. From my experience, I
have a simple:
in my init file. My `initial-major-mode' is `org-mode' and I've never
had an installation problem, even though I update `org-plus-contrib'
carelessly at will on a live session.
`async' is by John Wiegley, and available both at ELPA and MELPA.
Wouldn't it be worth mentioning it in the manual and/or in the
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2020-10-27 2:33 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-10-27 2:32 Documentation suggestion: Mention async-bytecomp-package-mode in the installation section of the manual Gustavo Barros
Code repositories for project(s) associated with this public inbox
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).