branch: externals/ef-themes
commit a230a2886e401f7a89bfbf41a7c9fc0c8aeff93a
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>

    Make all the obsolete aliases have a more informative doc string
---
 ef-themes.el | 99 +++++++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 88 insertions(+), 11 deletions(-)

diff --git a/ef-themes.el b/ef-themes.el
index 210ac85fde..bdf4262d55 100644
--- a/ef-themes.el
+++ b/ef-themes.el
@@ -213,37 +213,114 @@ and Modus into a single group, enable 
`modus-themes-include-derivatives-mode'."
 ;;;; Compatibility with older versions of the Ef themes
 
 (define-obsolete-function-alias 'ef-themes-rotate 'modus-themes-rotate
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-function-alias 'ef-themes-toggle 'modus-themes-toggle
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-disable-other-themes 
'modus-themes-disable-other-themes
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-headings 'modus-themes-headings
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only
+Ef themes, enable `ef-themes-take-over-modus-themes-mode'.
+Or, if you prefer to blend Ef and Modus into a single group,
+enable `modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-mixed-fonts 
'modus-themes-mixed-fonts
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-to-rotate 'modus-themes-to-rotate
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-to-toggle 'modus-themes-to-toggle
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-common-palette-overrides 
'modus-themes-common-palette-overrides
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-variable-pitch-ui 
'modus-themes-variable-pitch-ui
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-after-load-theme-hook 
'modus-themes-after-load-theme-hook
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 (define-obsolete-variable-alias 'ef-themes-post-load-hook 
'modus-themes-post-load-hook
-  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'; enable 
`ef-themes-take-over-modus-themes-mode'.")
+  "Since version 2.0.0, `ef-themes' derive from the `modus-themes'.
+You can configure the `ef-themes' via the user options of the
+`modus-themes'.
+
+To make all the Modus commands that operate on a theme consider only Ef
+themes, enable `ef-themes-take-over-modus-themes-mode'.  Or, if you
+prefer to blend Ef and Modus into a single group, enable
+`modus-themes-include-derivatives-mode' instead.")
 
 ;;;; Limit the Modus themes to only Ef themes
 

Reply via email to