Update to ef-themes version 1.4.01.4.0

1 files changed, 104 insertions, 0 deletions

diff --git a/CHANGELOG.org b/CHANGELOG.org
index 4b1fd8c..d8b12e8 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