Updating dotfiles.

.emacs.d/docs/api.org

@@ -152,7 +152,7 @@ It is integrated into Helpful, in Doom.
 
 *** custom-theme-set-faces!
 #+BEGIN_SRC elisp :eval no
-(custom-theme-set-faces! 'doom-one-theme
+(custom-theme-set-faces! 'doom-one
  '(outline-1 :weight normal)
  '(outline-2 :weight normal)
  '(outline-3 :weight normal)

.emacs.d/docs/faq.org

@@ -479,10 +479,10 @@ lines (200 characters+) and we've got ourselves a really poor experience. And
 that's before we factor in plugins and poorly optimized major modes.
 
 There is an unfortunate but necessary adjustment of expectations new users must
-undergo, when they adopt Emacs. Doom has inherited this curse. It's raison
-d'etre is to improve the situation, but I can only go so far, especially if you
-choose to enable all the most expensive features. You will unavoidable find
-cases where Emacs *is just slow*.
+undergo, when they adopt Emacs. Doom has inherited this curse. Its raison d'etre
+is to improve the situation, but I can only go so far, especially if you choose
+to enable all the most expensive features. You will unavoidably find cases where
+Emacs *is just slow*.
 
 What can you do about it?
 
@@ -492,7 +492,7 @@ What can you do about it?
    but can be a bit of a hassle to set up. There are packages available for
    [[https://aur.archlinux.org/packages/emacs-native-comp-git/][Arch Linux]], [[https://github.com/flatwhatson/guix-channel][Guix]] and [[https://github.com/nix-community/emacs-overlay][Nix users]]. [[https://www.emacswiki.org/emacs/GccEmacs][More information available on EmacsWiki]].
 3. Disable some of Doom's slowest modules. The biggest offenders tend to be:
-   =:ui tabs=, =:ui indent-guides=, =:ui pretty-code=, =:ui word-wrap= and =:ui
+   =:ui tabs=, =:ui indent-guides=, =:ui ligatures=, =:editor word-wrap= and =:ui
    vc-gutter=.
 4. Turn off line numbers ~(setq display-line-numbers-type nil)~. It's known to
    slow down scrolling, in particular.
@@ -1213,7 +1213,7 @@ Here are a few common causes for random crashes:
 
   Or disable the =:ui doom-dashboard= & =:tools magit= modules (see [[https://github.com/hlissner/doom-emacs/issues/1170][#1170]]).
 + Ligatures and some fonts can cause Emacs to crash. You may want to try a
-  different font, or disable the =:ui pretty-code= module.
+  different font, or disable the =:ui ligatures module.
 
 ** Can't load my theme; ~unable to find theme file for X~ errors
 This means Emacs can't find the X-theme.el file for the theme you want to load.

.emacs.d/docs/getting_started.org

@@ -52,8 +52,6 @@ us know!
     - [[#disabling-packages][Disabling packages]]
     - [[#changing-a-recipe-for-a-included-package][Changing a recipe for a included package]]
     - [[#usingloading-local-packages][Using/loading local packages]]
-      - [[#adjust-your-load-path][Adjust your ~load-path~]]
-      - [[#local-repo][:local-repo]]
   - [[#configuring-doom][Configuring Doom]]
     - [[#configuring-packages][Configuring packages]]
     - [[#reloading-your-config][Reloading your config]]
@@ -155,8 +153,7 @@ pacman -S git emacs ripgrep
 pacman -S fd
 #+END_SRC
 
-The above installs Emacs 26.3 (at the time of writing). To acquire Emacs 27
-[[https://aur.archlinux.org/packages/emacs27-git/][emacs27-git]] is available on the AUR.
+The above installs Emacs 27 (at the time of writing).
 
 **** NixOS
 On NixOS Emacs 26.3 can be installed via ~nix-env -Ai nixos.emacs~, or
@@ -248,8 +245,6 @@ to least recommended for Doom (based on compatibility).
   ln -s /usr/local/opt/emacs-plus/Emacs.app /Applications/Emacs.app
   #+END_SRC
 
-  Replace =emacs-plus= with =emacs-plus@27= to install Emacs 27.x instead.
-
 - [[https://bitbucket.org/mituharu/emacs-mac/overview][emacs-mac]] is another acceptable option. It offers slightly better integration
   with macOS, native emojis and better childframe support. However, at the time
   of writing, it [[https://github.com/railwaycat/homebrew-emacsmacport/issues/52][lacks multi-tty support]] (which impacts daemon usage):
@@ -917,40 +912,42 @@ changes.
 #+end_quote
 
 *** Using/loading local packages
-Say you have a local elisp package that you are developing, and want to
-"install" it for live testing. You have two options:
-
-**** Adjust your ~load-path~
-Emacs searches for packages in your ~load-path~. Add the path to your package
-and Emacs will find it when it tries to load it. e.g.
-
+Say you are developing an Emacs package locally and want to "install" it for
+live testing. To do this specify a ~:local-repo~ in that package's recipe:
 #+BEGIN_SRC elisp
-(add-load-path! "lisp/package")
+(package! my-package
+  :recipe (:local-repo "/path/to/my/package"))
+
+;; Relative paths are expanded to ~/.emacs.d/.local/straight/repos/{local-repo}
+;; or ~/.doom.d/{local-repo} -- the first that is found.
+(package! my-package
+  :recipe (:local-repo "my/package"))  ; looks for ~/.doom.d/my/package/my-package.el
+
+(package! my-package
+  :recipe (:local-repo "/path/to/my/package"
+
+           ;; By default, the package manager grabs all *.el files at the root
+           ;; of the project and nothing else. To include other files, or
+           ;; accommodate unconventional project structures, specify what :files
+           ;; you want:
+           :files ("*.el" "src/lisp/*.el")
+
+           ;; With ':no-byte-compile t' you can avoid having to run 'doom sync'
+           ;; every time you change the package.
+           :no-byte-compile t))
+#+END_SRC
+
+Alternatively, add the package's location to Emacs' ~load-path~. Do this if you
+don't need/care for autoload cookies or byte-compilation:
+#+BEGIN_SRC elisp
+;; Doom has modified `use-package's `:load-path' to expand relative paths from
+;; your DOOMDIR. e.g. ~/.doom.d/lisp/package
+(use-package my-package
+  :load-path "lisp/package")
 
 ;; or
 
-(use-package my-package
-  :load-path "/path/to/my/package")
-#+END_SRC
-
-**** :local-repo
-Alternatively, you can specify a ~:local-repo~ in a ~package!~'s ~:recipe~
-declaration:
-
-#+BEGIN_SRC elisp
-(package! my-package :recipe (:local-repo "/path/to/my/package"))
-
-;; Don't forget to use :files to include files in an unconventional project structure:
-(package! my-package
-  :recipe (:local-repo "/path/to/my/package"
-           :files ("*.el" "src/lisp/*.el")))
-
-;; It is recommended you use ':no-byte-compile t' as well, so you don't have to
-;; run `doom build -r` every time you make a change to your package.
-(package! my-package
-  :recipe (:local-repo "/path/to/my/package"
-           :files ("*.el" "src/lisp/*.el")
-           :no-byte-compile t))
+(add-load-path! "lisp/package")
 #+END_SRC
 
 #+begin_quote