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

    Add an appropriate description to each theme
---
 doric-cherry-theme.el   | 4 ++--
 doric-dark-theme.el     | 4 ++--
 doric-earth-theme.el    | 4 ++--
 doric-fire-theme.el     | 4 ++--
 doric-light-theme.el    | 4 ++--
 doric-marble-theme.el   | 4 ++--
 doric-oak-theme.el      | 4 ++--
 doric-obsidian-theme.el | 4 ++--
 doric-pine-theme.el     | 4 ++--
 doric-plum-theme.el     | 4 ++--
 doric-themes.el         | 8 +++++---
 doric-water-theme.el    | 4 ++--
 doric-wind-theme.el     | 4 ++--
 13 files changed, 29 insertions(+), 27 deletions(-)

diff --git a/doric-cherry-theme.el b/doric-cherry-theme.el
index ed52c5c0dc..78c0629b05 100644
--- a/doric-cherry-theme.el
+++ b/doric-cherry-theme.el
@@ -1,4 +1,4 @@
-;;; doric-cherry-theme.el --- Minimalist light theme -*- lexical-binding:t -*-
+;;; doric-cherry-theme.el --- Minimalist theme with light background and 
pink+purple hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#c2ebe8"))
   "Palette of `doric-cherry' theme.")
 
-  (doric-themes-define-theme doric-cherry light))
+  (doric-themes-define-theme doric-cherry light "Minimalist theme with light 
background and pink+purple hues"))
 
 (provide 'doric-cherry-theme)
 ;;; doric-cherry-theme.el ends here
diff --git a/doric-dark-theme.el b/doric-dark-theme.el
index ba9f0debb7..58be36ced8 100644
--- a/doric-dark-theme.el
+++ b/doric-dark-theme.el
@@ -1,4 +1,4 @@
-;;; doric-dark-theme.el --- Minimalist dark theme -*- lexical-binding:t -*-
+;;; doric-dark-theme.el --- Minimalist theme with dark background and cool 
hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#2f4f54"))
   "Palette of `doric-dark' theme.")
 
-  (doric-themes-define-theme doric-dark dark))
+  (doric-themes-define-theme doric-dark dark "Minimalist theme with dark 
background and cool hues"))
 
 (provide 'doric-dark-theme)
 ;;; doric-dark-theme.el ends here
diff --git a/doric-earth-theme.el b/doric-earth-theme.el
index da9a00b9f7..c8a676954f 100644
--- a/doric-earth-theme.el
+++ b/doric-earth-theme.el
@@ -1,4 +1,4 @@
-;;; doric-earth-theme.el --- Minimalist light theme -*- lexical-binding:t -*-
+;;; doric-earth-theme.el --- Minimalist theme with light background and brown 
hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#c9e6e0"))
     "Palette of `doric-earth' theme.")
 
-  (doric-themes-define-theme doric-earth light))
+  (doric-themes-define-theme doric-earth light "Minimalist theme with light 
background and brown hues"))
 
 (provide 'doric-earth-theme)
 ;;; doric-earth-theme.el ends here
diff --git a/doric-fire-theme.el b/doric-fire-theme.el
index 6286dcec3d..0c1ea4144b 100644
--- a/doric-fire-theme.el
+++ b/doric-fire-theme.el
@@ -1,4 +1,4 @@
-;;; doric-fire-theme.el --- Minimalist dark theme -*- lexical-binding:t -*-
+;;; doric-fire-theme.el --- Minimalist theme with dark background and orange 
hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#2f4954"))
   "Palette of `doric-fire' theme.")
 
-  (doric-themes-define-theme doric-fire dark))
+  (doric-themes-define-theme doric-fire dark "Minimalist theme with dark 
background and orange hues"))
 
 (provide 'doric-fire-theme)
 ;;; doric-fire-theme.el ends here
diff --git a/doric-light-theme.el b/doric-light-theme.el
index e7e4c4fb50..efc4b96b41 100644
--- a/doric-light-theme.el
+++ b/doric-light-theme.el
@@ -1,4 +1,4 @@
-;;; doric-light-theme.el --- Minimalist light theme -*- lexical-binding:t -*-
+;;; doric-light-theme.el --- Minimalist theme with light background and cool 
hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#c1ebe4"))
   "Palette of `doric-light' theme.")
 
-  (doric-themes-define-theme doric-light light))
+  (doric-themes-define-theme doric-light light "Minimalist theme with light 
background and cool hues"))
 
 (provide 'doric-light-theme)
 ;;; doric-light-theme.el ends here
diff --git a/doric-marble-theme.el b/doric-marble-theme.el
index eec355186a..a826f0bf78 100644
--- a/doric-marble-theme.el
+++ b/doric-marble-theme.el
@@ -1,4 +1,4 @@
-;;; doric-marble-theme.el --- Minimalist light theme -*- lexical-binding:t -*-
+;;; doric-marble-theme.el --- Minimalist theme with light grey background and 
rocky hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#c1ebe4"))
   "Palette of `doric-marble' theme.")
 
-  (doric-themes-define-theme doric-marble light))
+  (doric-themes-define-theme doric-marble light "Minimalist theme with light 
grey background and rocky hues"))
 
 (provide 'doric-marble-theme)
 ;;; doric-marble-theme.el ends here
diff --git a/doric-oak-theme.el b/doric-oak-theme.el
index 7a3d65e287..542d1e56f3 100644
--- a/doric-oak-theme.el
+++ b/doric-oak-theme.el
@@ -1,4 +1,4 @@
-;;; doric-oak-theme.el --- Minimalist light theme -*- lexical-binding:t -*-
+;;; doric-oak-theme.el --- Minimalist theme with light background and 
woody+earthly hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#bee0db"))
   "Palette of `doric-oak' theme.")
 
-  (doric-themes-define-theme doric-oak light))
+  (doric-themes-define-theme doric-oak light "Minimalist theme with light 
background and woody+earthly hues"))
 
 (provide 'doric-oak-theme)
 ;;; doric-oak-theme.el ends here
diff --git a/doric-obsidian-theme.el b/doric-obsidian-theme.el
index 7a0d7a19ba..63647f9960 100644
--- a/doric-obsidian-theme.el
+++ b/doric-obsidian-theme.el
@@ -1,4 +1,4 @@
-;;; doric-obsidian-theme.el --- Minimalist dark theme -*- lexical-binding:t -*-
+;;; doric-obsidian-theme.el --- Minimalist theme with dark grey background and 
rocky hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#2f4f54"))
   "Palette of `doric-obsidian' theme.")
 
-  (doric-themes-define-theme doric-obsidian dark))
+  (doric-themes-define-theme doric-obsidian dark "Minimalist theme with dark 
grey background and rocky hues"))
 
 (provide 'doric-obsidian-theme)
 ;;; doric-obsidian-theme.el ends here
diff --git a/doric-pine-theme.el b/doric-pine-theme.el
index 5318289a35..8ff028168f 100644
--- a/doric-pine-theme.el
+++ b/doric-pine-theme.el
@@ -1,4 +1,4 @@
-;;; doric-pine-theme.el --- Minimalist dark theme -*- lexical-binding:t -*-
+;;; doric-pine-theme.el --- Minimalist theme with dark background and 
woody+earthly hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#2f495f"))
   "Palette of `doric-pine' theme.")
 
-  (doric-themes-define-theme doric-pine dark))
+  (doric-themes-define-theme doric-pine dark "Minimalist theme with dark 
background and woody+earthly hues"))
 
 (provide 'doric-pine-theme)
 ;;; doric-pine-theme.el ends here
diff --git a/doric-plum-theme.el b/doric-plum-theme.el
index cb59d158f8..527086ae86 100644
--- a/doric-plum-theme.el
+++ b/doric-plum-theme.el
@@ -1,4 +1,4 @@
-;;; doric-plum-theme.el --- Minimalist dark theme -*- lexical-binding:t -*-
+;;; doric-plum-theme.el --- Minimalist theme with dark background and 
pink+purple hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#2f495f"))
   "Palette of `doric-plum' theme.")
 
-  (doric-themes-define-theme doric-plum dark))
+  (doric-themes-define-theme doric-plum dark "Minimalist theme with dark 
background and pink+purple hues"))
 
 (provide 'doric-plum-theme)
 ;;; doric-plum-theme.el ends here
diff --git a/doric-themes.el b/doric-themes.el
index 1ae0baf07f..5f1af877a6 100644
--- a/doric-themes.el
+++ b/doric-themes.el
@@ -1306,8 +1306,10 @@ Run `doric-themes-after-load-theme-hook' after loading a 
theme."
      faces)))
 
 ;;;###autoload
-(defmacro doric-themes-define-theme (name background-mode)
-  "Define theme with NAME and `light' or `dark' BACKGROUND-MODE."
+(defmacro doric-themes-define-theme (name background-mode &optional 
description)
+  "Define theme with NAME and `light' or `dark' BACKGROUND-MODE.
+With optional DESCRIPTION use it to describe the theme, otherwise
+default a generic text that mentions the BACKGROUND-MODE."
   (declare (indent 0))
   (unless (memq background-mode '(light dark))
     (error "The BACKGROUND-MODE must be either `light' or `dark'"))
@@ -1315,7 +1317,7 @@ Run `doric-themes-after-load-theme-hook' after loading a 
theme."
       `(progn
          (custom-declare-theme
           ',name 'doric-themes
-          ,(format "Minimalist %s theme." background-mode)
+          ,(or description (format "Minimalist %s theme." background-mode))
           (list :kind 'color-scheme :background-mode ',background-mode :family 
'doric))
          (let ,palette
            (custom-theme-set-faces
diff --git a/doric-water-theme.el b/doric-water-theme.el
index 0575626cf6..c2a5059684 100644
--- a/doric-water-theme.el
+++ b/doric-water-theme.el
@@ -1,4 +1,4 @@
-;;; doric-water-theme.el --- Minimalist dark theme -*- lexical-binding:t -*-
+;;; doric-water-theme.el --- Minimalist theme with dark background and 
blue+teal hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#2f495f"))
   "Palette of `doric-water' theme.")
 
-  (doric-themes-define-theme doric-water dark))
+  (doric-themes-define-theme doric-water dark "Minimalist theme with dark 
background and blue+teal hues"))
 
 (provide 'doric-water-theme)
 ;;; doric-water-theme.el ends here
diff --git a/doric-wind-theme.el b/doric-wind-theme.el
index 2c2cdcd471..deced3e9c6 100644
--- a/doric-wind-theme.el
+++ b/doric-wind-theme.el
@@ -1,4 +1,4 @@
-;;; doric-wind-theme.el --- Minimalist light theme -*- lexical-binding:t -*-
+;;; doric-wind-theme.el --- Minimalist theme with light background and 
green+teal hues -*- lexical-binding:t -*-
 
 ;; Copyright (C) 2025  Free Software Foundation, Inc.
 
@@ -74,7 +74,7 @@
       (bg-cyan "#c2ebe8"))
     "Palette of `doric-wind' theme.")
 
-  (doric-themes-define-theme doric-wind light))
+  (doric-themes-define-theme doric-wind light "Minimalist theme with light 
background and green+teal hues"))
 
 (provide 'doric-wind-theme)
 ;;; doric-wind-theme.el ends here

Reply via email to