docs: add doctor for dev versions of Emacs

The message simply test for the "not-a-version-yet" patch number and
displays an explanation to prepare users for raised error frequency and
having a backup version of Emacs if they do not want to deal with
issues.
This commit is contained in:
Gerry Agbobada 2021-11-20 18:32:59 +01:00 committed by GitHub
parent cd206ad1c7
commit 8d360474ac
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -50,6 +50,17 @@ in."
(print! (start "Checking your Emacs version...")) (print! (start "Checking your Emacs version..."))
(print-group! (print-group!
(cond (cond
((string= ".50" (substring emacs-version -3))
(error! "Emacs development version detected (%s)" emacs-version)
;; There are 2 newlines between each item to fight against
;; the (fill-region) call in `doom--output-autofill'
(explain! "Doom supports this version, but you are using a development version of Emacs! "
"Be prepared for possibly weekly breakages that\n\n"
"\t- you will have to investigate yourself,\n\n"
"\t- might appear, or be solved, on any Emacs update,\n\n"
"\t- might depend subtly on upstream packages updates\n\n"
"You might need to unpin packages to get a fix for a specific commit of Emacs, "
"and you should be ready to downgrade Emacs if something is just not fixable."))
(EMACS28+ (EMACS28+
(warn! "Emacs %s detected" emacs-version) (warn! "Emacs %s detected" emacs-version)
(explain! "Doom supports this version, but you are living on the edge! " (explain! "Doom supports this version, but you are living on the edge! "