Update to version 2.2.0

CHANGELOG.org

@@ -15,6 +15,113 @@ For further details, please consult these additional resources:
 + Manual :: <https://protesilaos.com/emacs/modus-themes>
 + Screenshots :: <https://protesilaos.com/emacs/modus-themes-pictures>
 
+* 2.2.0
+
+#+begin_src text
+Modus themes version 2.2.0
+
+By Protesilaos Stavrou <info@protesilaos.com> on 2022-02-23
+
+The present entry records the changes made to the project since the
+publication of version 2.1.0 on 2022-02-17.  This spans about 10 commits
+(though one of them is massive).  Normally the release cycle occurs over
+periods of 4-5 weeks.  This is a necessary exception.
+
+To access the URL of the manual visit this web page:
+<https://protesilaos.com/emacs/modus-themes>.  Or read it in the Emacs
+Info reader by evaluating this form:
+
+    (info "(modus-themes) Top")
+
+The 'modus-operandi' and 'modus-vivendi' themes are built into Emacs-28
+(next stable release) or later, and are available on GNU ELPA as well as
+other archives.  Emacs-28 ships version 1.6.0, while the current
+'master' branch (i.e. Emacs-29) and, by extension, GNU ELPA include the
+latest tagged release.
+
+
+Initialisation of user options
+==============================
+
+Removed a superfluous default value that hampered the initialisation of
+defcustom forms in the M-x customize interface.  Things would still
+work, but the interface was not looking right while editing the relevant
+variables.  Thanks to Gustavo Barros for reporting the bug in issue 267:
+<https://gitlab.com/protesilaos/modus-themes/-/issues/267>.
+
+
+Refactor 'modus-themes-completions'
+===================================
+
+Implemented thoroughgoing reforms across all completion User Interfaces
+(UIs) in order to make them more flexible/powerful and harmonise their
+looks.
+
+'modus-themes-completions' now accepts an alist instead of a symbol.
+Each cons cell is in the form of '(key . list-of-properties)'.  The doc
+string describes all the details.
+
+In terms of out-of-the-box appearences, all completion UIs have a subtle
+aesthetic.  This was always the case for the likes of Vertico, Icomplete
+(Fido), and related, though it constitutes a marked departure from what
+Ivy and Helm used to look like.  Users of the latter two can still get
+the more colourful or intense style with something like this:
+
+    (setq modus-themes-completions '((matches . (background intense))
+                                     (selection . (accented intense))
+                                     (popup . (accented intense))))
+
+Or simply:
+
+    (setq modus-themes-completions '((t background intense accented)))
+
+The documentation explains all those associations in-depth.  There also
+are other styles on offer (and combinations thereof).
+
+Furthermore, the new 'modus-themes-completions' encompasses more UIs
+than its predecessor, including Company and Corfu.
+
+In the interest of theme-wide consistency, all applicable faces have
+been reviewed.
+
+Finally, note that the previous tagged release also made changes on this
+front, but it did not disrupt the status quo that was in place from
+before the release of version 1.0.0 of the themes (more than a year
+ago).  In other words, it tried to make unnecessary compromises within
+the confines of an outdated design that did not fit in with the rest of
+the code base.  The new 'modus-themes-completions' might require manual
+intervention from users who want to customise things to their liking,
+though I feel this change is to our long-term benefit.
+
+Thanks to Daniel Mendler and Rudolf Adamkovič for their feedback in
+issue 278: <https://gitlab.com/protesilaos/modus-themes/-/issues/278>.
+And thanks to Kenta Usami for recommending the use of a warning in issue
+286: <https://gitlab.com/protesilaos/modus-themes/-/issues/286>.
+
+
+Miscellaneous changes
+=====================
+
++ Removed the pseudo-button effect from the 'org-checkbox' face.  It was
+  not up-to-date with the current style of the rest of the themes,
+  including the Org constructs for source block delimiters, the TODO
+  keywords, the priority cookies (e.g. '[#A]'), and others.
+
++ Introduced a section in the manual which provides an alternative to
+  the standard 'modus-themes-toggle' that leverages 'enable-theme'
+  instead of 'load-theme' under the hood.  These technicalities are all
+  explained in the manual.
+
++ Provided an alternative greyscale palette subset for 'modus-operandi'
+  in the manual's section about overriding colours.
+
++ Added support for the built-in 'custom-variable-obsolete' face.
+
++ Fixed typo in the 'modus-themes-box-buttons' variable.  Thanks to
+  Illia Ostapyshyn for the patch in merge request 58:
+  <https://gitlab.com/protesilaos/modus-themes/-/merge_requests/58>.
+#+end_src
+
 * 2.1.0
 
 #+begin_src text

doc/modus-themes.info

@@ -43,11 +43,11 @@ customization options for the ‘modus-operandi’ and ‘modus-vivendi’
 themes, and provides every other piece of information pertinent to them.
 
    The documentation furnished herein corresponds to stable version
-2.1.0, released on 2022-02-17.  Any reference to a newer feature which
+2.2.0, released on 2022-02-23.  Any reference to a newer feature which
 does not yet form part of the latest tagged commit, is explicitly marked
 as such.
 
-   Current development target is 2.2.0-dev.
+   Current development target is 2.3.0-dev.
 
 * Menu:
 
@@ -1220,9 +1220,7 @@ File: modus-themes.info,  Node: Completion UIs,  Next: Mail citations,  Prev: Ta
 4.12 Option for completion framework aesthetics
 ===============================================
 
-[ Refactored as part of 2.2.0-dev ]
-
-   Brief: Set the overall style of completion framework interfaces.
+Brief: Set the overall style of completion framework interfaces.
 
    Symbol: ‘modus-themes-completions’ (‘alist’ type properties)
 
@@ -6094,88 +6092,88 @@ Node: Command prompts40485
 Node: Mode line42306
 Node: Tab style46799
 Node: Completion UIs47462
-Node: Mail citations51210
-Node: Fringes52356
-Node: Language checkers53096
-Node: Line highlighting55538
-Node: Line numbers57135
-Node: Markup58203
-Node: Matching parentheses59796
-Node: Active region61173
-Node: Diffs62586
-Node: Org mode blocks64237
-Node: Org agenda66627
-Node: Heading styles75070
-Node: UI typeface79494
-Node: Advanced customization80393
-Node: More accurate colors in terminal emulators81981
-Node: Visualize the active Modus theme's palette83226
-Node: Per-theme customization settings84226
-Node: Case-by-case face specs using the themes' palette85582
-Node: Face specs at scale using the themes' palette90130
-Node: Remap face with local value94931
-Node: Cycle through arbitrary colors97356
-Node: Override colors103784
-Node: Override color saturation109022
-Node: Override colors through blending114701
-Node: Font configurations for Org and others117558
-Ref: Font configurations for Org and others-Footnote-1120374
-Node: Configure bold and italic faces120561
-Node: Custom Org todo keyword and priority faces124709
-Node: Custom Org emphasis faces128382
-Node: Update Org block delimiter fontification133183
-Node: Measure color contrast135100
-Node: Load theme depending on time of day137823
-Node: Backdrop for pdf-tools138816
-Node: Decrease mode line height141668
-Node: Toggle themes without reloading them145790
-Node: A theme-agnostic hook for theme loading147069
-Node: Diffs with only the foreground149471
-Node: Ediff without diff color-coding152585
-Node: Face coverage154680
-Node: Supported packages155132
-Node: Indirectly covered packages161648
-Node: Notes on individual packages162668
-Node: Note on avy hints163732
-Node: Note on calendarel weekday and weekend colors164900
-Node: Note on underlines in compilation buffers166083
-Node: Note on inline Latex in Org buffers166930
-Node: Note on dimmerel167540
-Node: Note on display-fill-column-indicator-mode169025
-Node: Note on highlight-parenthesesel170588
-Node: Note on mmm-modeel background colors176577
-Node: Note for prism178892
-Node: Note for god-mode182046
-Node: Note on company-mode overlay pop-up183650
-Ref: Note on company-mode overlay pop-up-Footnote-1184340
-Ref: Note on company-mode overlay pop-up-Footnote-2184407
-Node: Note on ERC escaped color sequences184462
-Ref: Note on ERC escaped color sequences-Footnote-1185890
-Node: Note on powerline or spaceline186000
-Node: Note on SHR colors186414
-Node: Note on SHR fonts186826
-Node: Note on Ement colors and fonts187459
-Node: Note on Helm grep188958
-Node: Note on vc-annotate-background-mode190435
-Node: Note on pdf-tools link hints191320
-Node: Frequently Asked Questions193752
-Node: Is the contrast ratio about adjacent colors?194383
-Node: What does it mean to avoid exaggerations?195890
-Node: Why are colors mostly variants of blue magenta cyan?197719
-Node: What is the best setup for legibility?202032
-Node: Are these color schemes?204677
-Node: Port the Modus themes to other platforms?208397
-Node: Contributing211181
-Node: Sources of the themes211578
-Node: Issues you can help with212214
-Node: Patches require copyright assignment to the FSF213414
-Node: Acknowledgements215709
-Node: Meta218718
-Node: GNU Free Documentation License221197
-Node: Indices246549
-Node: Function index246728
-Node: Variable index248251
-Node: Concept index250465
+Node: Mail citations51170
+Node: Fringes52316
+Node: Language checkers53056
+Node: Line highlighting55498
+Node: Line numbers57095
+Node: Markup58163
+Node: Matching parentheses59756
+Node: Active region61133
+Node: Diffs62546
+Node: Org mode blocks64197
+Node: Org agenda66587
+Node: Heading styles75030
+Node: UI typeface79454
+Node: Advanced customization80353
+Node: More accurate colors in terminal emulators81941
+Node: Visualize the active Modus theme's palette83186
+Node: Per-theme customization settings84186
+Node: Case-by-case face specs using the themes' palette85542
+Node: Face specs at scale using the themes' palette90090
+Node: Remap face with local value94891
+Node: Cycle through arbitrary colors97316
+Node: Override colors103744
+Node: Override color saturation108982
+Node: Override colors through blending114661
+Node: Font configurations for Org and others117518
+Ref: Font configurations for Org and others-Footnote-1120334
+Node: Configure bold and italic faces120521
+Node: Custom Org todo keyword and priority faces124669
+Node: Custom Org emphasis faces128342
+Node: Update Org block delimiter fontification133143
+Node: Measure color contrast135060
+Node: Load theme depending on time of day137783
+Node: Backdrop for pdf-tools138776
+Node: Decrease mode line height141628
+Node: Toggle themes without reloading them145750
+Node: A theme-agnostic hook for theme loading147029
+Node: Diffs with only the foreground149431
+Node: Ediff without diff color-coding152545
+Node: Face coverage154640
+Node: Supported packages155092
+Node: Indirectly covered packages161608
+Node: Notes on individual packages162628
+Node: Note on avy hints163692
+Node: Note on calendarel weekday and weekend colors164860
+Node: Note on underlines in compilation buffers166043
+Node: Note on inline Latex in Org buffers166890
+Node: Note on dimmerel167500
+Node: Note on display-fill-column-indicator-mode168985
+Node: Note on highlight-parenthesesel170548
+Node: Note on mmm-modeel background colors176537
+Node: Note for prism178852
+Node: Note for god-mode182006
+Node: Note on company-mode overlay pop-up183610
+Ref: Note on company-mode overlay pop-up-Footnote-1184300
+Ref: Note on company-mode overlay pop-up-Footnote-2184367
+Node: Note on ERC escaped color sequences184422
+Ref: Note on ERC escaped color sequences-Footnote-1185850
+Node: Note on powerline or spaceline185960
+Node: Note on SHR colors186374
+Node: Note on SHR fonts186786
+Node: Note on Ement colors and fonts187419
+Node: Note on Helm grep188918
+Node: Note on vc-annotate-background-mode190395
+Node: Note on pdf-tools link hints191280
+Node: Frequently Asked Questions193712
+Node: Is the contrast ratio about adjacent colors?194343
+Node: What does it mean to avoid exaggerations?195850
+Node: Why are colors mostly variants of blue magenta cyan?197679
+Node: What is the best setup for legibility?201992
+Node: Are these color schemes?204637
+Node: Port the Modus themes to other platforms?208357
+Node: Contributing211141
+Node: Sources of the themes211538
+Node: Issues you can help with212174
+Node: Patches require copyright assignment to the FSF213374
+Node: Acknowledgements215669
+Node: Meta218678
+Node: GNU Free Documentation License221157
+Node: Indices246509
+Node: Function index246688
+Node: Variable index248211
+Node: Concept index250425
 
 End Tag Table
 

doc/modus-themes.org

@@ -5,9 +5,9 @@
 #+options: ':t toc:nil author:t email:t num:t
 #+startup: content
 
-#+macro: stable-version 2.1.0
-#+macro: release-date 2022-02-17
-#+macro: development-version 2.2.0-dev
+#+macro: stable-version 2.2.0
+#+macro: release-date 2022-02-23
+#+macro: development-version 2.3.0-dev
 #+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
 #+macro: space @@texinfo:@: @@
 #+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@@ -1080,8 +1080,6 @@ Centaur tabs package.
 :end:
 #+vindex: modus-themes-completions
 
-[ Refactored as part of {{{development-version}}} ]
-
 Brief: Set the overall style of completion framework interfaces.
 
 Symbol: ~modus-themes-completions~ (=alist= type properties)

modus-operandi-theme.el

@@ -4,7 +4,7 @@
 
 ;; Author: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://gitlab.com/protesilaos/modus-themes
-;; Version: 2.1.0
+;; Version: 2.2.0
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: faces, theme, accessibility
 

modus-themes.el

@@ -4,8 +4,8 @@
 
 ;; Author: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://gitlab.com/protesilaos/modus-themes
-;; Version: 2.1.0
-;; Last-Modified: <2022-02-23 07:06:58 +0200>
+;; Version: 2.2.0
+;; Last-Modified: <2022-02-23 08:56:46 +0200>
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: faces, theme, accessibility
 

modus-vivendi-theme.el

@@ -4,7 +4,7 @@
 
 ;; Author: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://gitlab.com/protesilaos/modus-themes
-;; Version: 2.1.0
+;; Version: 2.2.0
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: faces, theme, accessibility