branch: externals/ef-themes
commit 3f10dea8d8f85ddb011e9beaf4ca1b107d2d9683
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to ef-themes version 1.4.0
---
CHANGELOG.org | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 14 +++-----
ef-themes.el | 2 +-
3 files changed, 110 insertions(+), 10 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index 4b1fd8ce5f..d8b12e8f5f 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,6 +9,110 @@ project's main git repository:
<https://git.sr.ht/~protesilaos/ef-themes>.
The newest release is at the top. For further details, please consult
the manual: <https://protesilaos.com/emacs/ef-themes>.
+* Version 1.4.0 on 2023-10-26
+:PROPERTIES:
+:CUSTOM_ID: h:bdacaf4d-35e9-4741-b676-795afe42cf74
+:END:
+
+** Experience the "Melissa" variants
+:PROPERTIES:
+:CUSTOM_ID: h:a62f2e19-ed30-46fb-8f06-2adb7c6fb54b
+:END:
+
+The ~ef-melissa-dark~ and ~ef-melissa-light~ are the new members of
+the Ef themes collection. They form a pair of warmly coloured palettes
+that have a strong emphasis on yellow hues against a soft background.
+In my opinion, these themes (as well as the "Elea" and "Maris"
+variants) are best used when environmental light is neither too
+intense nor too dim.
+
+The blog post where I announced these new themes and showed screen
+shots of them:
<https://protesilaos.com/codelog/2023-10-04-ef-melissa-dark-light/>.
+
+Screen shots for the entire collection are available on my website:
+<https://protesilaos.com/emacs/ef-themes-pictures>.
+
+There now are 28 themes in the ~ef-themes~ package, covering a broad
+range of preferences and needs. They all are highly legible (typically
+well above the WCAG AA standard) and very customisable (consult their
+manual).
+
+** Use palette overrides instead of ~ef-themes-region~
+:PROPERTIES:
+:CUSTOM_ID: h:6487eab7-f61b-4ec4-a7b4-bedf0a0445ce
+:END:
+
+The user option ~ef-themes-region~ is no more. It used to provide an
+intense variant to the region highlight colour. I am discontinuing
+this as the themes have a powerful mechanism of overriding any entry
+in their palette, with the benefit of semantic colour mappings, to
+affect the style of the theme.
+
+Palette overrides exist for each theme, but also as a common variable,
+with the former taking precedence. A theme-specific variable looks
+like ~ef-summer-palette-overrides~ while the common variable is
+~ef-themes-common-palette-overrides~. Preview palette entries with the
+command ~ef-themes-preview-colors~ or ~ef-themes-preview-colors-current~.
+
+The manual describes all the details, though here is a simple snippet
+to change the region of all themes to an intense yellow colour with an
+equally pronounced foreground (i.e. overriding the colour of any
+underlying text):
+
+#+begin_src emacs-lisp
+;; Evaluate and then reload the theme for changes to take effect. Use
+;; the command `ef-themes-preview-colors' to discover the names of
+;; palette entries to override/remap.
+(setq ef-themes-common-palette-overrides
+ '((bg-region bg-yellow-intense)
+ (fg-region fg-intense)))
+#+end_src
+
+** Git commit messages have more refined warnings
+:PROPERTIES:
+:CUSTOM_ID: h:cff8106f-8be2-4427-8d16-72eda35b3fad
+:END:
+
+While composing a Git commit message with either the ~magit~ package
+or the built-in ~vc-git~, the summary line can display text in a
+different colour to denote that it exceeds a certain character limit.
+Such a limit is a convention to keep logs readable, though it is not
+an error per se.
+
+The Ef themes used to apply a background to those warnings, though
+they now use only a foreground. The reason is that the styles I have
+picked are carefully designed to be unambiguous, without needing to
+exaggerate their mutual differences.
+
+** The ~breadcrumb~ package uses appropriate styles
+:PROPERTIES:
+:CUSTOM_ID: h:75b50e0f-d641-4065-a731-8615a1321b12
+:END:
+
+~breadcrumb~ is a new contribution by João Távora:
+<https://elpa.gnu.org/packages/breadcrumb.html>. It displays
+information about the context of the current code form or document
+heading in either the mode line or the header line. The styles it uses
+are now consistent with the aesthetics of each of the Ef themes.
+
+** Theme metadata for new Emacs versions is as intended
+:PROPERTIES:
+:CUSTOM_ID: h:3d9b951f-ce5b-409e-9dc5-4324fed6fa5c
+:END:
+
+This is about the very definition of each theme item, in order to
+support new features in Emacs where themes can specify the set they
+belong to, as well as whether they are light or dark. The built-in
+command that leverages this facility ~theme-choose-variant~. Though
+users of the Ef themes may prefer the commands ~ef-themes-select~,
+~ef-themes-toggle~ (if the user option ~ef-themes-to-toggle~ is
+configured), ~ef-themes-load-random~, ~ef-themes-select-dark~,
+~ef-themes-select-light~.
+
+This is in response to Emacs bug#65468:
+<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=65468>. Thanks to Mauro
+Aranda for bringing this matter to my attention.
+
* Version 1.3.0 on 2023-08-09
:PROPERTIES:
:CUSTOM_ID: h:9efcc469-4a83-49b5-a34c-0da68e17fc5f
diff --git a/README.org b/README.org
index 92b2674830..6c9bfe32cd 100644
--- a/README.org
+++ b/README.org
@@ -4,9 +4,9 @@
#+language: en
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
-#+macro: stable-version 1.3.0
-#+macro: release-date 2023-08-09
-#+macro: development-version 1.4.0-dev
+#+macro: stable-version 1.4.0
+#+macro: release-date 2023-10-26
+#+macro: development-version 1.5.0-dev
#+export_file_name: ef-themes.texi
#+texinfo_filename: ef-themes.info
#+texinfo_dir_category: Emacs misc features
@@ -588,8 +588,6 @@ is the override and the second is the original one.
:CUSTOM_ID: h:df1199d8-eaba-47db-805d-6b568a577bf3
:END:
-[ Part of {{{development-version}}}. ]
-
This section contains practical examples of overriding the palette of
the themes ([[#h:4b923795-4b23-4345-81e5-d1c108a84b6a][Palette overrides]]).
Users can copy the code to their init
file, evaluate it, and then re-load the theme for changes to take
@@ -601,8 +599,6 @@ call that loads the theme.
:CUSTOM_ID: h:c8605d37-66e1-42aa-986e-d7514c3af6fe
:END:
-[ Part of {{{development-version}}}. ]
-
This is one of our practical examples to override the semantic colors
of the Ef themes ([[#h:df1199d8-eaba-47db-805d-6b568a577bf3][Stylistic
variants using palette overrides]]). Here we
show how to make the region override the underlying text colors(i.e.
@@ -1313,7 +1309,7 @@ everything most users need.
- auctex
- auto-dim-other-buffers
- avy
-- breadcrumb [Part of {{{development-version}}}]
+- breadcrumb
- bongo
- bookmark
- calendar and diary
@@ -1327,7 +1323,7 @@ everything most users need.
- completions
- consult
- corfu
-- corfu-candidate-overlay [Part of {{{development-version}}}]
+- corfu-candidate-overlay
- csv-mode
- custom (=M-x customize=)
- dashboard
diff --git a/ef-themes.el b/ef-themes.el
index 8ba75b453c..e84307456a 100644
--- a/ef-themes.el
+++ b/ef-themes.el
@@ -6,7 +6,7 @@
;; Maintainer: Ef-Themes Development <~protesilaos/ef-the...@lists.sr.ht>
;; URL: https://git.sr.ht/~protesilaos/ef-themes
;; Mailing-List: https://lists.sr.ht/~protesilaos/ef-themes
-;; Version: 1.3.0
+;; Version: 1.4.0
;; Package-Requires: ((emacs "27.1"))
;; Keywords: faces, theme, accessibility
