[elpa] externals/ef-themes 24cf2c89dd 2/2: Update to version 0.4.0

[ELPA Syncer]

branch: externals/ef-themes
commit 24cf2c89dd3a083ec8c072366098d8bf34f413d5
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Update to version 0.4.0
---
 CHANGELOG.org | 214 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.org    |  18 ++---
 ef-themes.el  |   2 +-
 3 files changed, 222 insertions(+), 12 deletions(-)

diff --git a/CHANGELOG.org b/CHANGELOG.org
index e8bd99e77f..210f6f0819 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,6 +9,220 @@ 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.4.0 on 2022-08-29
+:PROPERTIES:
+:CUSTOM_ID: h:cc22cc5a-d787-4335-abf0-aa45cef92721
+:END:
+
+** New deuteranopia-friendly themes
+:PROPERTIES:
+:CUSTOM_ID: h:f94f8637-73c8-4e43-bc70-c17c42e76ad6
+:END:
+
+Designed two bespoke themes for users with red-green colour deficiency
+or blindness (deuteranopia).  They rely on blue and yellow hues.  Their
+names are:
+
++ ~ef-deuteranopia-dark~
++ ~ef-deuteranopia-light~
+
+Announcement with sample pictures:
+<https://protesilaos.com/codelog/2022-08-19-ef-themes-deuteranopia/>.
+
+** User options
+:PROPERTIES:
+:CUSTOM_ID: h:3dc43b00-843b-4827-b7cd-f381de619433
+:END:
+
++ Introduced the variable ~ef-themes-mixed-fonts~.  When it is set to a
+  non-nil (=t=) value, it makes spacing-sensitive elements use a
+  monospaced font.  For example, Org tables and code blocks will always
+  look properly aligned.  This is useful for those who either use a
+  proportionately spaced font as their default or enable the built-in
+  ~variable-pitch-mode~.
+
++ Implemented the variable ~ef-themes-variable-pitch-ui~.  When it is
+  set to a non-nil (=t=) value, it renders the mode-line, tab-bar-mode,
+  and tab-line-mode in a proportionately spaced font.
+
+User options must be set before the theme is loaded.  If an option
+changes, its value will be read upon a theme re-load.
+
+For font configurations, refer to my =fontaine= package.
+
+** Newly supported packages
+:PROPERTIES:
+:CUSTOM_ID: h:c1d351ca-1802-44b1-b43f-f9d5f7ba95d9
+:END:
+
+Built into Emacs:
+
++ eww
++ shell-script-mode (sh-mode)
++ shr
+
+External packages:
+
++ consult
++ embark
+
+** Refinements to faces
+:PROPERTIES:
+:CUSTOM_ID: h:582dea7b-454a-4500-871b-4ec45e875274
+:END:
+
++ Fixed the scaling of current line of ~display-line-numbers-mode~ when
+  ~text-scale-adjust~ was invoked.  Basically I forgot to include the
+  ~line-number~ face, while all others were covered.  Thanks to Anthony
+  Chavez for the feedback in issue 7 over at the GitHub mirror:
+  <https://github.com/protesilaos/denote/issues/7>.
+
++ Covered all faces that define group titles in completion contexts.
+  These are headings which are used by various commands, such as
+  ~consult-buffer~, ~consult-imenu~, and ~consult-grep~.  As they denote
+  a group name, we apply the =name= colour mapping (the hue differs for
+  each theme).  And since they are titles, we inherit from ~bold~ to
+  make them look like headings.  Thanks to Summer Emacs for the feedback
+  which amounted to:
+
+  1. Treating group titles as headings.
+  2. Using a more consistent colour theme-wide.
+
++ Revised the ~compilation-info~ face from a colour-coded "success" face
+  to a value that is consistent with the semantics of its application in
+  file names or related (as seen in the emacs.git repository).  For
+  example, file names in Grep or Xref buffers will now look like they
+  belong to the theme, whereas before they were predominantly green,
+  even when that did not make sense.  This point is connected to the
+  above, such as in workflows that go from the minibuffer to a Grep
+  buffer (e.g. with the use of the =embark= package).
+
++ Toned down the vertical border between windows by explicitly
+  supporting the ~vertical-border~ face.  The previous design would use
+  the main foreground which generally led to a disproportionately
+  intense result.
+
++ Adjusted all spacing-sensitive faces to accommodate the user option
+  ~ef-themes-mixed-fonts~, as noted above.  Also thanks to Christopher
+  League for spotting that I had missed the ~line-number~ face and for
+  providing the relevant patch (I do the same in the =modus-themes=):
+  
https://lists.sr.ht/~protesilaos/ef-themes/%3C871qt2x4wi.fsf%40nita.mail-host-address-is-not-set%3E
+
+  The patch is well below the ~15 line threshold and thus does not
+  require copyright assignment to the Free Software Foundation.
+
++ Enforced mono spacing for the ~org-indent~ face.  This is essential
+  for ~org-indent-mode~ to align entries correctly.  Thanks to Steve
+  Molitor for reporting this in the issue 9 over at the GitHub mirror:
+  <https://github.com/protesilaos/ef-themes/issues/9>.  Steve tested a
+  sample file with ~modus-vivendi~ and got the desired results.  It
+  reminded me how I handle this face in the =modus-themes=.
+
++ Added explicit support for the ~bold~ and ~italic~ faces.  The default
+  definition of ~italic~ has conditionality which we do not want, such
+  as drawing an underline if the font does not have italics (e.g. Fira
+  Code).  Styling it at the theme level prevents that from happening:
+  the font without italics will simply use the upright/roman glyphs.
+  Adding ~bold~ is just for clarity.  Its default definition is fine.
+
++ Made the tabs of the built-in ~tab-bar-mode~ and ~tab-line-mode~ stand
+  out more.  The difference between the current tab and the rest was too
+  subtle.  Depending on the lighting conditions, their respective
+  backgrounds were indistinguishable.  Thanks to Summer Emacs for
+  reporting this issue and for helping me decide on the final design.
+
++ Applied tinted backgrounds to values and arguments in transient.el
+  buffers (e.g. Magit).  They now stand out better.
+
+** Documentation
+:PROPERTIES:
+:CUSTOM_ID: h:5549f628-390d-478c-b8d3-a0b068f3f1e0
+:END:
+
++ Created a page with screenshots of all the Ef themes:
+  <https://protesilaos.com/emacs/ef-themes-pictures>.
+
++ Answered the Frequently Asked Question of letting Org tags inherit the
+  foreground colour of the heading they belong to.  The gist (though
+  note that the entry also mentions the option for the non-alignment of
+  tags):
+
+  #+begin_quote
+  Upstream Org defines tags in headings to have the same color as the rest
+  of the heading's text.  However, tags are a distinct component of the
+  heading as noted in the doc string of the ~org-get-heading~ function.
+  Tags also are functionally different than the ordinary text of the
+  heading: they are a clickable link/button.  It thus is a matter of
+  usability to render this distinction clear at the visual level: I do not
+  agree with upstream Org's design decision.
+  #+end_quote
+
++ Addressed another Frequently Asked Question on whether we can have
+  Ef-style themes inspired by the Nord or Zenburn themes.  The short
+  version is that this is technically difficult and undesirable.  Each
+  palette in the Ef themes collection is original and is designed around
+  the normative and aesthetic principles of this project.
+
++ Wrote an entire section on Do-It-Yourself customisations.  These
+  generally are for advanced users, though the manual provides concrete
+  examples of using the ~ef-themes-with-colors~ macro in tandem with the
+  ~ef-themes-post-load-hook~.
+
++ Elaborated on the list of packages that I will most likely NOT support
+  in the Ef themes.  The reasons vary though.  Quote:
+
+  #+begin_quote
+  These are difficult to support due to their (i) incompatibility with
+  the design of the =ef-themes=, (ii) complexity or multiple points of
+  entry, (iii) external dependencies, (iv) existence of better
+  alternatives in my opinion, or (v) inconsiderate use of color
+  out-of-the-box and implicit unwillingness to be good Emacs citizens
+  #+end_quote
+
+  If a certain package does not look right, then it is not supported
+  (yet).
+
+The manual can be read from Emacs, if the =ef-themes= package is
+installed.  Evaluate:
+
+#+begin_src emacs-lisp
+(info "(ef-themes) Top")
+#+end_src
+
+Else visit: <https://protesilaos.com/emacs/ef-themes>.
+
+** Internal refinements
+:PROPERTIES:
+:CUSTOM_ID: h:4013a8aa-d2ff-45a1-95db-edd140e31cb1
+:END:
+
++ Recalibrated diff colours or the context of diff buffers, especially
+  in Magit, to improve usability.
+
++ Adjusted or otherwise tweaked the hues that apply to key bindings and
+  links in order to reinforce the stylistic consistency of each theme.
+
++ Introduced a yellow-tinted background which is used in various
+  contexts that (i) should be styled with a coloured background but (ii)
+  should not be colour-coded as either red or green/blue.
+
++ Made the ~ef-themes-with-colors~ macro always reify the current Ef
+  theme's palette.  This macro is for advanced users.  Its utility is
+  documented in the themes' manual.
+
++ Fixed how themes become "known" at startup.  Before, they were not
+  registered correctly for immediate use with the ~ef-themes-select~
+  command.  Thanks to Jean-Philippe Gagné Guay for the feedback in issue
+  6 over at the GitHub mirror: 
<https://github.com/protesilaos/denote/issues/6>.
+
++ Tweaked some face attributes to work with Emacs 27.
+
++ Tinkered with the colour mapping or precise values of practically all
+  the themes.  Better consult the Git log for the minutiae.  I think the
+  identity of each theme is largely defined, though there may still be
+  tweaks to be done here and there until we eventually reach version
+  =1.0.0=.
+
 * Version 0.3.0 on 2022-08-20
 :PROPERTIES:
 :CUSTOM_ID: h:f91c2c29-cc5b-4cf3-a322-f3a286a17e8c
diff --git a/README.org b/README.org
index 3f8c9b999e..5f262d22cd 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.3.0
-#+macro:                 release-date 2022-08-20
-#+macro:                 development-version 0.4.0-dev
+#+macro:                 stable-version 0.4.0
+#+macro:                 release-date 2022-08-29
+#+macro:                 development-version 0.5.0-dev
 #+export_file_name:      ef-themes.texi
 #+texinfo_filename:      ef-themes.info
 #+texinfo_dir_category:  Emacs misc features
@@ -221,8 +221,6 @@ minibuffer completion or at random 
([[#h:58345e8c-2bec-459c-872c-a85a29e9fe97][C
 :CUSTOM_ID: h:621d3bb9-5967-4f97-b253-7470bba9168c
 :END:
 
-[ Part of {{{development-version}}} ]
-
 #+vindex: ef-themes-mixed-fonts
 The user option ~ef-themes-mixed-fonts~ controls whether strictly
 spacing-sensitive constructs inherit from ~fixed-pitch~ (a monospaced
@@ -252,8 +250,6 @@ Protesilaos) can be helpful in that regard.
 :CUSTOM_ID: h:7c3d1057-c4a7-43b3-b91b-9887264d4072
 :END:
 
-[ Part of {{{development-version}}} ]
-
 #+vindex: ef-themes-variable-pitch-ui
 The user option ~ef-themes-variable-pitch-ui~ controls whether the
 elements of the User Interface (UI) use a proportionately spaced font.
@@ -782,7 +778,7 @@ everything most users need.
 - chart
 - compilation
 - completions
-- consult [ Part of {{{development-version}}} ]
+- consult
 - custom (M-x customize)
 - denote
 - dictionary
@@ -795,10 +791,10 @@ everything most users need.
 - ediff
 - eldoc
 - elfeed
-- embark [ Part of {{{development-version}}} ]
+- embark
 - epa
 - eshell
-- eww [ Part of {{{development-version}}} ]
+- eww
 - font-lock
 - git-commit
 - git-rebase
@@ -828,7 +824,7 @@ everything most users need.
 - ruler-mode
 - shell-script-mode (sh-mode)
 - show-paren-mode
-- shr [ Part of {{{development-version}}} ]
+- shr
 - smerge
 - tab-bar-mode
 - tab-line-mode
diff --git a/ef-themes.el b/ef-themes.el
index 7978cf0bb7..c78b5fd8f4 100644
--- a/ef-themes.el
+++ b/ef-themes.el
@@ -6,7 +6,7 @@
 ;; Maintainer: Ef-Themes Development <~protesilaos/ef-themes@lists.sr.ht>
 ;; URL: https://git.sr.ht/~protesilaos/ef-themes
 ;; Mailing-List: https://lists.sr.ht/~protesilaos/ef-themes
-;; Version: 0.3.4
+;; Version: 0.4.0
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: faces, theme, accessibility