docs/getting_started: revise Chemacs install guide

This commit is contained in:
Henrik Lissner 2019-12-13 14:21:01 -05:00
parent e4477f02e3
commit 10ccf27d20
No known key found for this signature in database
GPG key ID: 5F6C0EA160557395

View file

@ -16,7 +16,7 @@
- [[#wsl2][WSL2]] - [[#wsl2][WSL2]]
- [[#doom-emacs][Doom Emacs]] - [[#doom-emacs][Doom Emacs]]
- [[#install-doom-manually][Install Doom Manually]] - [[#install-doom-manually][Install Doom Manually]]
- [[#alongside-other-emacs-configs-with-chemacs][Alongside other Emacs configs (with Chemacs)]] - [[#install-doom-alongside-other-configs-with-chemacs][Install Doom alongside other configs (with Chemacs)]]
- [[#externalsystem-dependencies][External/system dependencies]] - [[#externalsystem-dependencies][External/system dependencies]]
- [[#update][Update]] - [[#update][Update]]
- [[#doom][Doom]] - [[#doom][Doom]]
@ -316,25 +316,31 @@ emacs --batch -f all-the-icons-install-fonts
To understand the purpose of the =~/.doom.d= directory and =~/.doom.d/init.el= To understand the purpose of the =~/.doom.d= directory and =~/.doom.d/init.el=
file, see the [[#customize][Customize]] section further below. file, see the [[#customize][Customize]] section further below.
*** Alongside other Emacs configs (with Chemacs) *** Install Doom alongside other configs (with Chemacs)
[[https://github.com/plexus/chemacs][Chemacs]] is a bootloader for Emacs. It makes it easy to switch between multiple [[https://github.com/plexus/chemacs][Chemacs]] is a bootloader for Emacs; it makes it easy to switch between multiple
Emacs configurations. Here is a quick guide for setting it up with Doom Emacs as Emacs configurations. Here is a quick guide for setting it up with Doom Emacs as
the default config. the default config.
After you've followed the installation instructions for Doom and Emacs, outlined 1. First, install Doom somewhere:
above, deploy [[https://raw.githubusercontent.com/plexus/chemacs/master/.emacs][the Chemacs' startup script]] to =~/.emacs=:
#+BEGIN_SRC sh
git clone https://github.com/hlissner/doom-emacs ~/doom-emacs
~/doom-emacs/bin/doom install
#+END_SRC
2. Download [[https://raw.githubusercontent.com/plexus/chemacs/master/.emacs][the Chemacs' startup script]] to =~/.emacs=:
#+BEGIN_SRC bash #+BEGIN_SRC bash
wget -O ~/.emacs https://raw.githubusercontent.com/plexus/chemacs/master/.emacs wget -O ~/.emacs https://raw.githubusercontent.com/plexus/chemacs/master/.emacs
#+END_SRC #+END_SRC
#+begin_quote #+begin_quote
*Warning: the =~/.emacs.d= directory must not exist for this to work.* *WARNING:* the =~/.emacs.d= directory must not exist for this to work.
#+end_quote #+end_quote
Then create =~/.emacs-profiles.el= with a list of your Emacs profiles. This file 3. Create =~/.emacs-profiles.el= with a list of your Emacs profiles. This file
is structured like a =.dir-locals.el= file. Here is an example with Doom (as the is structured like a =.dir-locals.el= file. Here is an example with Doom (as
default), Spacemacs, and Prelude: the default), Spacemacs, and Prelude:
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(("default" . ((user-emacs-directory . "~/doom-emacs"))) (("default" . ((user-emacs-directory . "~/doom-emacs")))