branch: externals/ef-themes
commit cf4ae83a54ca87457f5d24701ccacfe7c6309930
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to version 0.5.0
---
CHANGELOG.org | 232 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 36 ++++-----
ef-themes.el | 2 +-
3 files changed, 248 insertions(+), 22 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index 210f6f0819..9eb4a77a2b 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,6 +9,238 @@ 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 0.5.0 on 2022-09-11
+:PROPERTIES:
+:CUSTOM_ID: h:d0d24c93-7954-4c52-b5a2-79089b53c767
+:END:
+
+** New duo-chrome themes
+:PROPERTIES:
+:CUSTOM_ID: h:dfdea23c-8d89-4461-8668-04a317fb498d
+:END:
+
+The collection now includes two items which apply shades of blue and
+yellow in most interfaces. The themes are named ~ef-duo-dark~ and
+~ef-duo-light~.
+
+Read the announcement:
+<https://protesilaos.com/codelog/2022-09-06-ef-themes-duo/>.
+
+View all image samples:
+<https://protesilaos.com/emacs/ef-themes-pictures>.
+
+The choice of blue and yellow is largely stylistic: it is not done to
+accommodate users with red-green colour deficiency. For that case, the
+Ef themes provide ~ef-deuteranopia-dark~ and ~ef-deuteranopia-light~.
+
+** Bespoke accent colours for the mode line
+:PROPERTIES:
+:CUSTOM_ID: h:db9d8e1d-d33c-46a5-b41c-8bbb19e0b8af
+:END:
+
+Each theme now includes a subset of foreground values optimised for use
+against the active mode line's background. The active mode line's
+background is accented, meaning that we cannot use colours that are
+otherwise decent against the main background.
+
+These new entries are meant to style warnings, errors, and other
+notifications that appear on the mode line. They empower us to extend
+support for packages that make use of such colour-coding (more further
+below).
+
+** "Subtle" accented backgrounds
+:PROPERTIES:
+:CUSTOM_ID: h:1935e028-10ea-4a3f-adb5-a755c1ddfe2b
+:END:
+
+Each theme's palette now contains six accented backgrounds that are not
+very intense. These are used by packages that need to (i) highlight a
+line or region, (ii) preserve a modicum of legibility without overriding
+existing foreground values (more below about new packages).
+
+** Refined the colour of prompts, where necessary
+:PROPERTIES:
+:CUSTOM_ID: h:5a1f7bde-658a-4240-bab8-92cb8e5327b0
+:END:
+
+Each theme's palette now includes a dedicated =prompt= mapping. This
+gives us full control over what colour we use for prompts. In some
+themes the prompt will look the same as before, though I made a few
+changes to have stylistic consistency in each theme. Specifically:
+
+| Theme | Old prompt | New prompt |
+|-----------------------+--------------+----------------|
+| ef-deuteranopia-dark | cyan-warmer | yellow |
+| ef-deuteranopia-light | cyan | blue |
+| ef-duo-dark | green-cooler | yellow |
+| ef-duo-light | green-cooler | blue |
+| ef-spring | blue | green |
+| ef-summer | cyan-cooler | magenta-warmer |
+| ef-winter | green-cooler | magenta-warmer |
+
+In short: we don't want prompts to look blue/green all the time. Some
+themes have a different character.
+
+** Newly supported packages
+:PROPERTIES:
+:CUSTOM_ID: h:197a98a6-96d3-47ca-935d-6736d3836211
+:END:
+
+In general, if a package does not look right, it is not supported by the
+Ef themes. What we have for this release:
+
++ auctex :: Thanks to Philip Kaludercic for providing the sample file
+ that let me view the relevant faces, as well as for helping me
+ correct some mistakes of mine:
+
<https://lists.sr.ht/~protesilaos/ef-themes/%3C87h71t97hl.fsf%40posteo.net%3E>.
+
++ company :: Thanks to Alan Schmitt for reminding me about it:
+ <https://lists.sr.ht/~protesilaos/ef-themes/%3C87pmgjw3j9.fsf%40m4x.org%3E>.
+
++ dirvish :: Thanks to Alex Lu (=dirvish= developer) for the
+ contribution. This was done in pull request 14 at the GitHub mirror:
+ <https://github.com/protesilaos/ef-themes/pull/14>. The change is
+ below the ~15 line threshold and thus does not require copyright
+ assignment to the Free Software Foundation.
+
++ doom-modeline :: Expanded support for almost all the faces it
+ provides. The only exception is some debugging-related indicators
+ that I do not know how to trigger (contact me, if you encounter them).
+ This support is made possible by the new accented foregrounds that are
+ designed specifically for the mode line.
+
++ gnus :: Expanded support for all the faces it defines. I had used
+ Gnus for several months before and am familiar with its interfaces.
+ Though I never made use of its scoring system. I think the relevant
+ faces look okay, though please let me know if we can refine them
+ further.
+
++ image-dired :: This is made possible by the new "subtle" coloured
+ backgrounds that I added to each theme.
+
++ lin (my package) :: Made possible by the new subtle backgrounds.
+
++ pulsar (my package) :: Same as above.
+
++ pulse :: Same.
+
++ recursion-indicator :: Same
+
++ selectrum :: Made it look like the already supported =vertico=.
+
++ tempel :: Same as =lin= and friends.
+
+** Refinements to existing faces
+:PROPERTIES:
+:CUSTOM_ID: h:83fa9e74-0460-49b0-a123-15767d07f806
+:END:
+
++ Lots of small tweaks affect mode line indicators, per the new
+ foreground colours I introduced. Expect to see a bit more colour in
+ the mode line when using =magit=, compilation buffers, appointment
+ reminders, keyboard macros, Org agenda filters, and more.
+
++ All the =rcirc= faces have been revised in the interest of thematic
+ consistency.
+
+ - Rcirc uses the new foregrounds for the mode line, where relevant.
+
+ - Indicators that track/highlight the user's nick use the same
+ paradigm.
+
+ - IRC server messages look like comments in code buffers.
+
+ Thanks to Philip Kaludercic for telling me about the downsides of
+ using the ~italic~ in the ~rcirc-nick-in-message-full-line~ face:
+
<https://lists.sr.ht/~protesilaos/ef-themes/%3C87edwphahl.fsf%40posteo.net%3E>.
+
+ Please note that I am not a regular/experienced IRC user. If there
+ are improvements to be made, I am happy to implement them but will
+ likely need your help (I will ask the relevant questions).
+
+** New fallback behaviour for ~ef-themes-toggle~
+:PROPERTIES:
+:CUSTOM_ID: h:3399f33c-3d1b-4d18-b50f-8d2f0838aa54
+:END:
+
+The command ~ef-themes-toggle~ will switch between two themes specified
+in the user option ~ef-themes-to-toggle~. For example:
+
+#+begin_src emacs-lisp
+;; Toggle between `ef-summer' and `ef-winter' using `ef-themes-toggle'.
+(setq ef-themes-to-toggle '(ef-summer ef-winter))
+#+end_src
+
+By default, ~ef-themes-to-toggle~ is nil. In the past, this meant that
+~ef-themes-toggle~ would do nothing out-of-the-box. To improve the
+initial user experience, the command will now fall back to minibuffer
+completion to load a theme if ~ef-themes-to-toggle~ does not have the
+expected value. The completion candidates are the items of the Ef
+themes collection. This fallback behaviour is essentially the same as
+what the user gets by invoking the ~ef-themes-select~ command.
+
+When ~ef-themes-to-toggle~ is set properly, the corresponding command
+will perform the switch, as intended.
+
+This is based on the discussion with Philip Kaludercic about revising
+the ~ef-themes-toggle~ command to have a more Do-What-I-Mean behaviour:
+<https://lists.sr.ht/~protesilaos/ef-themes/%3C878rmwfs0e.fsf%40posteo.net%3E>.
+
+** Improved how ~ef-themes-load-random~ picks subsets
+:PROPERTIES:
+:CUSTOM_ID: h:4407d5a6-b837-4168-88b2-f7b175978122
+:END:
+
+The ~ef-themes-load-random~ command accepts a prefix argument (=C-u=, by
+default): it prompts the user for a =dark= or =light= subset out of the
+collection. Once that is selected, the command loads a theme at random.
+
+Before, the prompt was using minibuffer completion, but this has now
+changed to a ~read-multiple-choice~ function, meaning that =d= selects
+=dark= and =l= selects =light=. Basically, we skip possible extra key
+presses.
+
+Thanks to Philip Kaludercic for the patch:
+<https://lists.sr.ht/~protesilaos/ef-themes/patches/35089>.
+
+** Internal changes
+:PROPERTIES:
+:CUSTOM_ID: h:b9156099-0bcd-4974-9cdf-ada73d5745ce
+:END:
+
++ Fixed the initial colors' list in the ~ef-themes-with-colors~ macro.
+ Thanks to Steve Molitor for telling me that the previous design would
+ not work if ~ef-light~ was not loaded. This was done in issue 11 at
+ the GitHub mirror:
+ <https://github.com/protesilaos/ef-themes/issues/11>.
+
++ Simplified the helper function ~ef-themes--current-theme~. Thanks to
+ Jonas Collberg for the feedback in issue 12 over at the GitHub mirror:
+ <https://github.com/protesilaos/ef-themes/issues/12>. Also thanks to
+ Jonas for the subsequent patch in pull request 13:
+ <https://github.com/protesilaos/ef-themes/pull/13>. The change is
+ below the ~15 line threshold and thus does not require copyright
+ assignment to the Free Software Foundation.
+
++ Refined the colour mapping of some themes to improve overall
+ aesthetics and/or usability, without deviating from the theme's
+ established character. For example, in the ~ef-dark~ I adjusted the
+ mappings for dates, links, and names. This helps distinguish all
+ elements, while retaining the overall looks of the design. Some
+ contexts where that is relevant:
+
+ - Notmuch search buffers
+ - Magit commit log
+ - Org clocktables
+ - Org documents with links, to-do, etc.
+
+ I will not cover all such technicalities. Please consult the Git
+ commit log. If, however, some new combination of colours feels
+ awkward, you are welcome to tell me about it.
+
++ Made improvements to the manual and implemented other internal
+ changes.
+
* Version 0.4.0 on 2022-08-29
:PROPERTIES:
:CUSTOM_ID: h:cc22cc5a-d787-4335-abf0-aa45cef92721
diff --git a/README.org b/README.org
index e12a7914ff..26b6650662 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 0.4.0
-#+macro: release-date 2022-08-29
-#+macro: development-version 0.5.0-dev
+#+macro: stable-version 0.5.0
+#+macro: release-date 2022-09-11
+#+macro: development-version 0.6.0-dev
#+export_file_name: ef-themes.texi
#+texinfo_filename: ef-themes.info
#+texinfo_dir_category: Emacs misc features
@@ -213,8 +213,6 @@ includes a list with all relevant symbols. The user can
then switch
between the two specified themes by invoking the ~ef-themes-toggle~
command.
-[ The fallback behaviour of selecting a theme is part of
{{{development-version}}}. ]
-
If ~ef-themes-to-toggle~ does not specify two Ef themes, inform the user
about it while prompting with completion for a theme among our
collection (this is practically the same as the ~ef-themes-select~
@@ -428,10 +426,6 @@ argument (=C-u= by default) makes the command limit the
random selection
to either light or dark themes. The user is prompted at the minibuffer
to pick among the two sets.
-[ As part of {{{development-version}}} the choice between =light= and
- =dark= sets in ~ef-themes-load-random~ is done using the function
- ~read-multiple-choice~. Before, it was ~completing-read~. ]
-
The ~ef-themes-load-random~ can also be called from Lisp (e.g. from the
=init.el= file):
@@ -808,13 +802,13 @@ everything most users need.
- all-the-icons-dired
- all-the-icons-ibuffer
- ansi-color
-- auctex [ Part of {{{development-version}}} ]
+- auctex
- bongo
- bookmark
- calendar and diary
- change-log and log-view (part of VC)
- chart
-- company [ Part of {{{development-version}}} ]
+- company
- compilation
- completions
- consult
@@ -826,8 +820,8 @@ everything most users need.
- dired
- dired-subtree
- diredfl
-- dirvish [ Part of {{{development-version}}} ]
-- doom-modeline [ Expanded as part of {{{development-version}}} ]
+- dirvish
+- doom-modeline
- ediff
- eldoc
- elfeed
@@ -838,12 +832,12 @@ everything most users need.
- font-lock
- git-commit
- git-rebase
-- gnus [ Added all faces as part of {{{development-version}}} ]
-- image-dired [ Part of {{{development-version}}} ]
+- gnus
+- image-dired
- info
- isearch, occur, query-replace
- keycast
-- lin [ Part of {{{development-version}}} ]
+- lin
- line numbers (~display-line-numbers-mode~ and global variant)
- magit
- man
@@ -860,21 +854,21 @@ everything most users need.
- outline-mode
- outline-minor-faces
- package (M-x list-packages)
-- pulsar [ Part of {{{development-version}}} ]
-- pulse [ Part of {{{development-version}}} ]
+- pulsar
+- pulse
- rainbow-delimiters
- rcirc
-- recursion-indicator [ Part of {{{development-version}}} ]
+- recursion-indicator
- regexp-builder (re-builder)
- ruler-mode
-- selectrum [ Part of {{{development-version}}} ]
+- selectrum
- shell-script-mode (sh-mode)
- show-paren-mode
- shr
- smerge
- tab-bar-mode
- tab-line-mode
-- tempel [ Part of {{{development-version}}} ]
+- tempel
- term
- textsec
- transient
diff --git a/ef-themes.el b/ef-themes.el
index dc83833e6e..1a4b6408ff 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: 0.4.2
+;; Version: 0.5.0
;; Package-Requires: ((emacs "27.1"))
;; Keywords: faces, theme, accessibility
