awesome-emacs/doomemacs
1
0
Fork 0
mirror of https://github.com/doomemacs/doomemacs synced 2025-08-03 12:27:26 -05:00
Code Issues Packages Projects Releases Wiki Activity

docs: revise Emacs version warnings

Browse Source
This commit is contained in:
Henrik Lissner
2024-10-02 05:22:46 -04:00
parent ad29be39f6
commit c88516d6bb
1 changed files with 12 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
lisp/cli/doctor.el
View File

@ -58,23 +58,25 @@ in."
(string-match-p ".\\([56]0\\|9[0-9]\\)$" emacs-version)) (string-match-p ".\\([56]0\\|9[0-9]\\)$" emacs-version))
(warn! "Detected a development version of Emacs (%s)" emacs-version) (warn! "Detected a development version of Emacs (%s)" emacs-version)
(if (> emacs-major-version 29) (if (> emacs-major-version 29)
(explain! "This is the bleeding edge of Emacs. As it is constantly changed, Doom will not " (explain! "This is the bleeding edge of Emacs. As it is constantly changing, Doom will not "
"(officially) support it. If you've found a stable commit, great! But be " "(officially) support it. If you've found a stable commit, great! But be cautious "
"cautious about updating Emacs too eagerly!\n") "about updating Emacs too eagerly!\n")
(explain! "A .50, .60, or .9X appended to the version string indicates that this is a version " (explain! "A version that ends in .50, .60, or .9X indicates a build of Emacs in between "
"of Emacs in between stable releases. These are not well supported.\n")) "stable releases (i.e. development builds). Doom does not support these well.\n"))
(explain! "Because development builds are prone to random breakage, there will be a greater " (explain! "Because development builds are prone to random breakage, there will be a greater "
"burden on you to investigate and deal with issues. Please make extra sure that " "burden on you to investigate and deal with issues. Please make extra sure that "
"your issue is reproducible in 29.1 before reporting them to Doom's issue tracker!\n" "your issue is reproducible on a stable version (between 27.1 and 29.4) before "
"reporting them to Doom's issue tracker!\n"
"\n" "\n"
"If this doesn't phase you, read the \"Why does Doom not support Emacs HEAD\" QnA " "If this doesn't phase you, read the \"Why does Doom not support Emacs HEAD\" QnA "
"in Doom's FAQ. It offers some advice for debugging and surviving issues on the " "in Doom's FAQ. It offers some advice for debugging and surviving issues on the "
"bleeding edge. Failing that, 29.1 is highly recommended and will always be " "bleeding edge. Failing that, the latest stable release of Emacs will always be "
"Doom's best supported version of Emacs.")) "Doom's best supported version of Emacs."))
((= emacs-major-version 27) ((= emacs-major-version 27)
(warn! "Emacs 27 is supported, but consider upgrading to 28.1") (warn! "Emacs 27 is supported, but not for long!")
(explain! "Emacs 28.1 is better supported, faster, and more stable. Plus, Doom will drop " (explain! "Doom will drop 27.x support sometime late-2024. It's recommended that you upgrade "
"27.x support sometime late-2023.")))) "to the latest stable release (currently 29.4). It is better supported, faster, and "
"more stable."))))
(print! (start "Checking for Doom's prerequisites...")) (print! (start "Checking for Doom's prerequisites..."))
(print-group! (print-group!