diff --git a/CHANGELOG.org b/CHANGELOG.org index d4dd01e..e1e4d30 100644 --- a/CHANGELOG.org +++ b/CHANGELOG.org @@ -15,6 +15,113 @@ For further details, please consult these additional resources: + Manual :: + Screenshots :: +* 2.2.0 + +#+begin_src text +Modus themes version 2.2.0 + +By Protesilaos Stavrou 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: +. 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: +. + + +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: . +And thanks to Kenta Usami for recommending the use of a warning in issue +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: + . +#+end_src + * 2.1.0 #+begin_src text diff --git a/doc/modus-themes.info b/doc/modus-themes.info index 0db3678..28315d1 100644 --- a/doc/modus-themes.info +++ b/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 diff --git a/doc/modus-themes.org b/doc/modus-themes.org index cca0ee5..70f1e8b 100644 --- a/doc/modus-themes.org +++ b/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) diff --git a/modus-operandi-theme.el b/modus-operandi-theme.el index aac5b04..f71962e 100644 --- a/modus-operandi-theme.el +++ b/modus-operandi-theme.el @@ -4,7 +4,7 @@ ;; Author: Protesilaos Stavrou ;; URL: https://gitlab.com/protesilaos/modus-themes -;; Version: 2.1.0 +;; Version: 2.2.0 ;; Package-Requires: ((emacs "27.1")) ;; Keywords: faces, theme, accessibility diff --git a/modus-themes.el b/modus-themes.el index 36e6197..067fc22 100644 --- a/modus-themes.el +++ b/modus-themes.el @@ -4,8 +4,8 @@ ;; Author: Protesilaos Stavrou ;; 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 diff --git a/modus-vivendi-theme.el b/modus-vivendi-theme.el index 3e78a6c..7d38e5c 100644 --- a/modus-vivendi-theme.el +++ b/modus-vivendi-theme.el @@ -4,7 +4,7 @@ ;; Author: Protesilaos Stavrou ;; URL: https://gitlab.com/protesilaos/modus-themes -;; Version: 2.1.0 +;; Version: 2.2.0 ;; Package-Requires: ((emacs "27.1")) ;; Keywords: faces, theme, accessibility