docs: don't recommend doom/reload

Many users seem to treat `doom/reload` like a 1-to-1 replacement for
`doom sync` + restart Emacs (which it is not), and are surprised when it
fails to properly "reload" their config. I'm considering removing
`doom/reload` altogether for this reason, or turning it into a light
wrapper around `restart-emacs`, but for now I'll settle for recommending
it less in documentation and comments. The references in docs/*.org will
be dealt with later.
This commit is contained in:
Henrik Lissner
2024-11-25 20:23:32 -05:00
parent bbbfb85393
commit bf9249d002
2 changed files with 2 additions and 3 deletions

View File

@ -99,7 +99,7 @@ OPTIONS:
(unless noupdate? (doom-packages-update (not update?)))
(doom-packages-purge purge? purge? purge? purge? purge?)
(when (doom-profile-generate)
(print! (item "Restart Emacs or use 'M-x doom/reload' for changes to take effect"))
(print! (item "Restart Emacs for changes to take effect"))
(run-hooks 'doom-after-sync-hook))
(when (or rebuild? (not (file-exists-p doom-cli-sync-info-file)))
(with-temp-file doom-cli-sync-info-file

View File

@ -2,8 +2,7 @@
;;; $DOOMDIR/packages.el
;; To install a package with Doom you must declare them here and run 'doom sync'
;; on the command line, then restart Emacs for the changes to take effect -- or
;; use 'M-x doom/reload'.
;; on the command line, then restart Emacs for the changes to take effect.
;; To install SOME-PACKAGE from MELPA, ELPA or emacsmirror: