emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs/getting_started: revise Chemacs install guide

Browse source
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
1 changed files with 25 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

40
docs/getting_started.org
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,31 +316,37 @@ 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 bash #+BEGIN_SRC sh
wget -O ~/.emacs https://raw.githubusercontent.com/plexus/chemacs/master/.emacs git clone https://github.com/hlissner/doom-emacs ~/doom-emacs
#+END_SRC ~/doom-emacs/bin/doom install
#+END_SRC
#+begin_quote 2. Download [[https://raw.githubusercontent.com/plexus/chemacs/master/.emacs][the Chemacs' startup script]] to =~/.emacs=:
*Warning: the =~/.emacs.d= directory must not exist for this to work.*
#+end_quote
Then create =~/.emacs-profiles.el= with a list of your Emacs profiles. This file #+BEGIN_SRC bash
is structured like a =.dir-locals.el= file. Here is an example with Doom (as the wget -O ~/.emacs https://raw.githubusercontent.com/plexus/chemacs/master/.emacs
default), Spacemacs, and Prelude: #+END_SRC
#+BEGIN_SRC emacs-lisp #+begin_quote
(("default" . ((user-emacs-directory . "~/doom-emacs"))) *WARNING:* the =~/.emacs.d= directory must not exist for this to work.
#+end_quote
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 default), Spacemacs, and Prelude:
#+BEGIN_SRC emacs-lisp
(("default" . ((user-emacs-directory . "~/doom-emacs")))
("spacemacs" . ((user-emacs-directory . "~/spacemacs"))) ("spacemacs" . ((user-emacs-directory . "~/spacemacs")))
("prelude" . ((user-emacs-directory . "~/prelude")))) ("prelude" . ((user-emacs-directory . "~/prelude"))))
#+END_SRC #+END_SRC
To start Emacs with a specific config, use the =--with-profile= option: To start Emacs with a specific config, use the =--with-profile= option: