diff --git a/CHANGELOG.org b/CHANGELOG.org index 531ba65..12a93b7 100644 --- a/CHANGELOG.org +++ b/CHANGELOG.org @@ -15,6 +15,444 @@ For further details, please consult these additional resources: + Manual :: + Screenshots :: +* 1.5.0 + +#+begin_src text +Modus themes version 1.5.0 + +By Protesilaos Stavrou on 2021-07-15 + +This entry outlines the set of changes made to the project since the +release of version 1.4.0 on 2021-05-25. There have been over 130 +commits since then. + +Every colour-related modification referenced herein is always +implemented in accordance with the primary accessibility objective of +the themes for a minimum contrast ratio of 7:1 between background and +foreground values in their given combination (the WCAG AAA standard). +Such edits also account for colour-coding that is optimised for the +needs of users with red-green colour deficiency (deuteranopia or +variants). + +Here is the URL of the manual: . +Or read it from Emacs by evaluating this form: + + (info "(modus-themes) Top") + +The themes are built into Emacs version 28 (current development target), +and are available on GNU ELPA as well as other archives. + + +Customisation options +===================== + +Overview of new style of sets of properties +------------------------------------------- + +Several variables now accept a list of symbols as a value. Those +represent properties, which can be combined with each other to realise +the possible styles. The idea was to simplify their specification in +order to make them easier to both maintain and extend. Thanks to Philip +Kaludercic for introducing this concept in issue 210: +. + +The variables are: + ++ 'modus-themes-prompts' by Philip Kaludercic in merge request 43: + + ++ 'modus-themes-mode-line' by Philip Kaludercic in merge request 40: + . + ++ 'modus-themes-lang-checkers' by Philip Kaludercic in merge request 46: + + ++ 'modus-themes-org-agenda' ++ 'modus-themes-links' ++ 'modus-themes-headings' ++ 'modus-themes-hl-line' ++ 'modus-themes-paren-match' ++ 'modus-themes-region' ++ 'modus-themes-syntax' + +Take 'modus-themes-syntax' as an example. Up until version 1.4.0, it +would only accept a symbol, signifying a predefined style. So we had +the possible value 'faint' and another 'faint-yellow-comments'. To make +a third variant of the "faint" aesthetic, such as by combining it with +the "alt syntax" and/or "green strings", we would need to write new +presets in the form of 'faint-green-strings', 'faint-alt-syntax', +'faint-alt-syntax-green-strings', 'faint-green-strings-yellow-comments', +'faint-alt-syntax-green-strings-yellow-comments'. That would have been +inefficient, hence why it was not done. + +With the new approach of defining a list of properties, those +combinations are all possible. Such as: + + (setq modus-themes-syntax '(faint alt-syntax)) + + (setq modus-themes-syntax '(yellow-comments alt-syntax green-strings)) + +The order in which the properties are set is not significant. + +The doc string of each of the aforementioned variables, or the +corresponding entry in the manual, provides guidance on how to configure +things. The old forms will continue to work for the time being, though +they are considered deprecated and will stop being supported at a future +date. + + +Changes in stylistic variants for variables with sets of properties +------------------------------------------------------------------- + ++ The meaning of the "alt syntax" style in 'modus-themes-syntax' has + been redefined. In the past, it used to have green-coloured strings + and doc strings. Those are now red. Some other changes have been + implemented to make the overall looks more consistent. Users who + liked the old style can retain it by passing this list of properties: + + (alt-syntax green-strings) + + New styles for the "faint" aesthetic are possible, here shown as lists + of properties: + + (faint green-strings) + (faint alt-syntax) + (faint alt-syntax green-strings) + + To each of those the 'yellow-comments' property can be added as well. + + Consult the doc string or the manual for the technicalities and code + samples. + ++ The 'modus-themes-hl-line' no longer has styles that include only an + underline. Those proved to be problematic under certain circumstances + and were thus removed. + + Minor changes have been implemented to make the following combination + of properties more consistent, by colourising the underline: + + (accented intense underline) + ++ The 'modus-themes-paren-match' now has styles that include an + 'underline' property. Those extend the old options, such as: + + (bold intense underline) + ++ The 'modus-themes-headings' have an improved set of styles for the "no + text color" aesthetic. Those involve the 'monochrome' property, which + can now yield results that include a background (whereas before it was + just colourless text for the headings, optionally without a bold + weight). As this is an alist, here is an example (always check the + docs for fully fledged code samples): + + (setq modus-themes-headings + '((1 . (background overline)) + (2 . (overline background rainbow)) + (t . (monochrome no-bold background)))) + + To allow a heading level N to retain its original style, a 't' value + can be passed. In the previous version of the themes, it was possible + to use 'nil' for the same purpose, though that is no longer valid. In + those cases, the fallback value of the alist will be used instead, + such as what is noted above: + + (t . (monochrome no-bold background)) + ++ The 'modus-themes-links' provide several new possible styles, due to + an expanded set of properties that includes, among others, 'bold', + 'italic', and 'background'. The documentation covers the details. + ++ The 'modus-themes-lang-checkers' can now attain a style that uses a + prominently coloured background in addition to what was available + before as a subtle background and the other variants. + + +New variables +------------- + ++ The 'modus-themes-org-agenda' provides the means to refashion the + entirety of the Org agenda buffer. The value it accepts is an alist, + with some keys expecting a symbol and others a list of properties. + The minutia are covered in its doc string. A possible configuration + can look like this: + + (setq modus-themes-org-agenda + '((header-block . (variable-pitch scale-title)) + (header-date . (grayscale workaholic bold-today)) + (scheduled . uniform) + (habit . traffic-light))) + + 'modus-themes-org-agenda' supersedes the old variable that was specific + to the Org habit graph: 'modus-themes-org-habit'. There now is a + 'habit' key which accepts the same values as before, plus a new style + that is optimised for users with red-green colour deficiency: + 'traffic-light-deuteranopia'. Please consult the doc string of + 'modus-themes-org-agenda' or the relevant entry to the manual. + + Thanks to Gustavo Barros for contributing to the creation of this + variable as well as to all other changes in the relevant faces that + were done in the interest of usability. A full report about + 'modus-themes-org-agenda' with screen shots is available here: + . + + A patch has been sent to upstream Org, with its review pending, which + improves upon some of the areas we had identified: + . + ++ The 'modus-themes-inhibit-reload' controls a new behaviour of + automatically reloading the active theme when an option is set via the + Custom interfaces or with 'customize-set-variable'. To opt-in to this + feature, set the variable to a 'nil' value. + + Thanks to Philip Kaludercic for implementing this in merge request 40: + . + + In the development phase of this option, a bug was identified + pertaining to recursion, as reported by Gustavo Barros in issue 213: + . Changes + have been made to remove that possibility, as found in merge request + 45: . + + A thread was started on the emacs-devel mailing list to inquire upon + the technicalities of this option, but it did not gain any traction: + . + + As such, we have decided to take our chances by pressing on with this + feature. Users who are interested in it are encouraged to give it a + try and report any possible complications. Issue 213 remains open. + ++ The 'modus-themes-italic-constructs' is the new name of the variable + 'modus-themes-slanted-constructs'. The term "slant" was considered + too vague or technical and some users could have missed the meaning of + this option. + ++ The 'modus-themes-scale-5' is renamed to 'modus-themes-scale-title' to + better convey its utility. + + +Changes to the manual +===================== + ++ Rewrote or introduced the documentation for all the customisation + options mentioned above. Also updated relevant code samples, such as + in the manual's introduction to the customisation options. Evaluate + this form for an annotated code overview: + + (info "(modus-themes) Customization Options") + ++ Rephrased a reference to "gamma ray values" as "gamma values". Thanks + to Anders Johansson for the contribution in merge request 42: + . + ++ Removed the Org macro that would insert the build date in the manual's + introduction. This was required to make the file reproducible, + otherwise it would keep changing each time a new version of Emacs was + built. Refer to Emacs bug#48661 by Glenn Morris: + . + ++ Included note on tweaking the key hints that the Avy package produces. + This is in response to issue 215 by Rudolf Adamkovič: + . Thanks to + Nicolas De Jaeghere for providing the text. + ++ Wrote a note on how to control the underlines that are generated in + compilation-mode buffers and related. It is about configuring the + variable 'compilation-message-face'. + ++ Documented how to configure the colours that are applied to the names + of the days in the 'M-x calendar' interface. The relevant variable is + 'calendar-weekend-days'. + ++ Elaborated on a "do it yourself" (DIY) guide on how to benefit from + the hidden feature of the themes about how they handle the bold weight + and the italic slant. In short, we do not hardcode values and thus + make it easy for users to specify the particularities of what it means + for a face to have a 'bold' or 'italic' attribute. + + +Faces and face groups +===================== + +New entries +----------- + +Newly supported packages: + ++ 'ledger-mode'. Thanks to Pengji Zhang for the feedback in issue 202: + . + ++ 'gotest'. Thanks to Jerry Zhang for the feedback in issue 226: + . + ++ 'css-mode' + +New faces for already supported groups: + ++ 'shr-h1', 'shr-h2', 'shr-h3', 'shr-h4', 'shr-h5', 'shr-h6' of the + shr.el library (simple HTML renderer, as experienced in, for example, + EWW). Those are available for Emacs28, with a patch by me: + + ++ 'apropos-button' as a generic face that fontifies faces in apropos + buffers. Available for Emacs28, with a patch by me: + . + ++ 'selectrum-mouse-highlight'. This makes the mouse hover effect for + selectrum look the same as in most other contexts. Thanks to okamsn + for the feedback in issue 203: + . + + +Review of existing entries +-------------------------- + ++ Added an ':extend' property to 'next-error' face. This face is used + for pulse effects. It is good to have them extend to the edge of the + window, so that they are easier to spot. Thanks to Gustavo Barros for + the feedback in issue 200, which is about pulse.el: + . + ++ Tweaked the various Apropos faces. The idea was to remove the colour + from the pseudo headings so that we would not get an exaggerated + result of too much variety in the buffer (e.g. that of 'M-x apropos'). + The individual buttons retain their style as links, meaning that they + are governed by the variable 'modus-themes-links'. + ++ Revised 'whitespace-line' face to make it look like a warning, as it + ought to be. Thanks to Pengji Zhang for the feedback in issue 204: + . + ++ Reworked the colour-coding of the Hydra and Transient packages. These + are meant to tone down some excesses with the standard red and to + adapt other colours to it. Thanks to Gustavo Barros for providing + suggestions and helping me tweak those in issue 206: + . + ++ Recoloured 'transient-argument' to improve its uniqueness in its + context and to better comply with the expectation of hydra-style + colour coding, as noted right above. + ++ Made the 'org-agenda-done' face conform with the customisation option + 'modus-themes-success-deuteranopia'. This means that it will be + coloured in blue instead of green when the option is set to a non-nil + value. + ++ Grayed out the foreground of the Org block delimiter lines on the + premise that any extra colouration was not needed, given the presence + of a gray background and the overall markup of the block. + ++ Toned down the colouration of the 'org-code' face, so that it is + consistent with 'org-verbatim' as well as the colours used in opening + and closing lines of blocks. Thanks to Gustavo Barros for suggesting + this change in issue 206, though it went through a couple of reviews: + . + ++ Simplified the inheritance of the 'fixed-pitch' face, which is used + for internal purposes to ensure alignment of elements in buffers that + must cope with mixed font configurations, such as an org-mode file + with 'M-x variable-pitch-font' enabled. + + [ Recall that the option 'modus-themes-no-mixed-fonts' can disable + this feature. Also note that the 'mixed-fonts' package, or + equivalent, is not needed while using the Modus themes (though there + is nothing wrong with having them together). ] + ++ Reduced the overall intensity of 'org-mode-line-clock-overrun'. + Thanks to Gustavo Barros for the feedback in issue 208: + . + ++ Simplified or otherwise tweaked several Org agenda faces to render + possible the new 'modus-themes-org-agenda' variable, as documented + above. Thanks to Gustavo Barros for the feedback in issue 208: + . + ++ Increased ever so slightly the foreground colour of the 'highlight' + face. This can help improve the perception of highlights, such as + upon hovering over a link with the mouse. Thanks to Rudolf Adamkovič + for reporting the potential problem in issue 216: + . + ++ Prevented the override of the 'diff-context' face when users assign a + 'bg-only' value to the 'modus-themes-diffs' variable. This makes it + consistent with the intent of this style, which is to work with a + non-nil value for 'diff-font-lock-syntax' (basically to allow the + usual colour highlights of the underlying code syntax in diff + buffers). + ++ Ensured consistency of all prompt-related faces by introducing a new + face, 'modus-themes-prompt', that is inherited by all others (all + prompt styles are controlled by the variable 'modus-themes-prompts'). + This was originally implemented with the 'comint-highlight-prompt' + face, though that could potentially lead to undefined faces if the + comint library was not loaded. Whereas the 'modus-themes-prompt' + guarantees that we pass a known face at all times. Thanks to Philip + Kaludercic for bringing this potential bug to my attention in a + comment to merge request 43: + . + ++ Removed the background colour from the 'widget-inactive' face. It + would create problems in some cases, such as in Custom buffers for + multiple choice options. + ++ Refined 'calendar-weekend-header' and 'calendar-weekday-header' to + emulate the design of physical calendars and remain truthful to the + expectations set by the default configuration of the calendar.el + library. Weekends now use a faint red, while weekdays are rendered in + the same subtle gray they had before. The underlying principle is to + make weekends convey a subtle warning to the effect that "this is not + a day for work" (notwithstanding precarious economic realities). As + noted above, there is an entry in the manual on how to make all days + look the same, be it gray or faint red. Evaluate this form: + + (info "(modus-themes) Note on calendarel weekday and weekend colors") + + +Request for feedback on a potential version 2.0.0 of the Modus themes +===================================================================== + +While we maintain a cautious stance towards preserving the default +styles, there are some cases where we might be forced to introduce +backward-incompatible changes. + +Three such cases that can benefit from user feedback are: + ++ Issue 196 on 'modus-themes-no-mixed-fonts' + . + ++ Issue 198 on 'modus-themes-hl-line' + + + [ Note that 'modus-themes-hl-line now accepts a list of properties as + described in the opening sections of this entry. ] + ++ Issue 218 on 'modus-themes-diffs' + . + + +Miscellaneous +============= + ++ Recalibrated the value of the colour 'bg-hl-line-intense' in the + palette 'modus-themes-vivendi-colors'. The change should be + practically indecipherable, though it slightly improves things in + certain contexts. + ++ Refined the intensity of the three main yellow colours in + 'modus-themes-vivendi-colors'. + ++ Introduced a new 'modus-themes-faces' group so that those are + decoupled from the customisation options in the various Custom + buffers. Thanks to Philip Kaludercic for the patch in merge request + 39: . + ++ Updated the manual's "Acknowledgements" section to include all new + users who contributed to the project. + +Thanks again to everyone involved! + + +#+end_src + * 1.4.0 #+begin_src text diff --git a/doc/modus-themes.info b/doc/modus-themes.info index e12f953..acb8023 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 -1.4.0, released on 2021-05-25. Any reference to a newer feature which +1.5.0, released on 2021-07-15. 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 1.5.0-dev. + Current development target is 1.6.0-dev. * Menu: @@ -110,7 +110,6 @@ Customization Options * Diffs:: Choose among intense, desaturated, or text-only diffs * Org mode blocks:: Choose among plain, gray, or tinted backgrounds * Org agenda:: Control each element in the presentation of the agenda -* Org agenda habits:: Choose among standard, simplified, or traffic light styles * Heading styles:: Choose among several styles, also per heading level * Scaled headings:: Toggle scaling of headings * UI typeface:: Toggle the use of variable-pitch across the User Interface @@ -621,7 +620,6 @@ of this manual. * Diffs:: Choose among intense, desaturated, or text-only diffs * Org mode blocks:: Choose among plain, gray, or tinted backgrounds * Org agenda:: Control each element in the presentation of the agenda -* Org agenda habits:: Choose among standard, simplified, or traffic light styles * Heading styles:: Choose among several styles, also per heading level * Scaled headings:: Toggle scaling of headings * UI typeface:: Toggle the use of variable-pitch across the User Interface @@ -633,9 +631,7 @@ File: modus-themes.info, Node: Custom reload theme, Next: Success' color-code, 4.1 Option for inhibiting theme reload ====================================== -[ Part of 1.5.0-dev ] - - Symbol: ‘modus-themes-inhibit-reload’ +Symbol: ‘modus-themes-inhibit-reload’ Possible values: @@ -734,9 +730,7 @@ File: modus-themes.info, Node: Syntax styles, Next: No mixed fonts, Prev: Ita 4.5 Option for syntax highlighting ================================== -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-syntax’ +Symbol: ‘modus-themes-syntax’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -822,9 +816,7 @@ File: modus-themes.info, Node: Link styles, Next: Command prompts, Prev: No m 4.7 Option for links ==================== -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-links’ +Symbol: ‘modus-themes-links’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -891,9 +883,7 @@ File: modus-themes.info, Node: Command prompts, Next: Mode line, Prev: Link s 4.8 Option for command prompt styles ==================================== -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-prompts’ +Symbol: ‘modus-themes-prompts’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -944,9 +934,7 @@ File: modus-themes.info, Node: Mode line, Next: Completion UIs, Prev: Command 4.9 Option for mode line presentation ===================================== -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-mode-line’ +Symbol: ‘modus-themes-mode-line’ Possible values, which can be expressed as a list of combinations of box effect, color, and border visibility: @@ -1118,9 +1106,7 @@ File: modus-themes.info, Node: Language checkers, Next: Line highlighting, Pr 4.13 Option for language checkers ================================= -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-lang-checkers’ +Symbol: ‘modus-themes-lang-checkers’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -1176,9 +1162,7 @@ File: modus-themes.info, Node: Line highlighting, Next: Line numbers, Prev: L 4.14 Option for line highlighting (hl-line-mode) ================================================ -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-hl-line’ +Symbol: ‘modus-themes-hl-line’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -1252,9 +1236,7 @@ File: modus-themes.info, Node: Matching parentheses, Next: Active region, Pre 4.16 Option for parenthesis matching (show-paren-mode) ====================================================== -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-paren-match’ +Symbol: ‘modus-themes-paren-match’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -1298,9 +1280,7 @@ File: modus-themes.info, Node: Active region, Next: Diffs, Prev: Matching par 4.17 Option for active region ============================= -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-region’ +Symbol: ‘modus-themes-region’ Possible values are expressed as a list of properties (default is ‘nil’ or an empty list). The list can include any of the following @@ -1425,15 +1405,12 @@ delimiter fontification (DIY). aliases for ‘gray-background’ and ‘tinted-background’, respectively.  -File: modus-themes.info, Node: Org agenda, Next: Org agenda habits, Prev: Org mode blocks, Up: Customization Options +File: modus-themes.info, Node: Org agenda, Next: Heading styles, Prev: Org mode blocks, Up: Customization Options 4.20 Option for Org agenda constructs ===================================== -[ Part of 1.5.0-dev. Supersedes ‘modus-themes-org-habit’ (*note Option -for org-habit graph styles: Org agenda habits.). ] - - Symbol: ‘modus-themes-org-agenda’ +Symbol: ‘modus-themes-org-agenda’ This is an alist that accepts a ‘(key . value)’ combination. Some values are specified as a list. Here is a sample, followed by a @@ -1556,56 +1533,12 @@ are passed as a symbol. Those are: (habit . traffic-light)))  -File: modus-themes.info, Node: Org agenda habits, Next: Heading styles, Prev: Org agenda, Up: Customization Options +File: modus-themes.info, Node: Heading styles, Next: Scaled headings, Prev: Org agenda, Up: Customization Options -4.21 Option for org-habit graph styles -====================================== - -[ Deprecated and superseded by ‘modus-themes-org-agenda’ in 1.5.0-dev -(*note Option for Org agenda constructs: Org agenda.). ] - - Symbol: ‘modus-themes-org-habit’ - - Possible values: - - 1. ‘nil’ (default) - 2. ‘simplified’ - 3. ‘traffic-light’ - - The default is meant to conform with the original aesthetic of -‘org-habit’. It employs all four color codes that correspond to the -org-habit states—clear, ready, alert, and overdue—while distinguishing -between their present and future variants. This results in a total of -eight colors in use: red, yellow, green, blue, in tinted and shaded -versions. They cover the full set of information provided by the -‘org-habit’ consistency graph. - - Option ‘simplified’ is like the default except that it removes the -dichotomy between current and future variants by applying uniform -color-coded values. It applies a total of four colors: red, yellow, -green, blue. They produce a simplified consistency graph that is more -legible (or less “busy”) than the default. The intent is to shift focus -towards the distinction between the four states of a habit task, rather -than each state’s present/future outlook. - - Option ‘traffic-light’ further reduces the available colors to red, -yellow, and green. As in ‘simplified’, present and future variants -appear uniformly, but differently from it, the ’clear’ state is rendered -in a green hue, instead of the original blue. This is meant to capture -the use-case where a habit task being “too early” is less important than -it being “too late”. The difference between ready and clear states is -attenuated by painting both of them using shades of green. This option -thus highlights the alert and overdue states. - - -File: modus-themes.info, Node: Heading styles, Next: Scaled headings, Prev: Org agenda habits, Up: Customization Options - -4.22 Option for the headings’ overall style +4.21 Option for the headings’ overall style =========================================== -[ Refactored as part of 1.5.0-dev ] - - Symbol: ‘modus-themes-headings’ +Symbol: ‘modus-themes-headings’ This is an alist that accepts a ‘(key . list-of-values)’ combination. The key is either a number, representing the heading’s level or ‘t’, @@ -1685,7 +1618,7 @@ others, such as ‘org-fontify-done-headline’.  File: modus-themes.info, Node: Scaled headings, Next: UI typeface, Prev: Heading styles, Up: Customization Options -4.23 Option for scaled headings +4.22 Option for scaled headings =============================== Symbol: ‘modus-themes-scale-headings’ @@ -1708,7 +1641,7 @@ Info.  File: modus-themes.info, Node: Scaled heading sizes, Up: Scaled headings -4.23.1 Control the scale of headings +4.22.1 Control the scale of headings ------------------------------------ In addition to the toggle for enabling scaled headings, users can also @@ -1772,7 +1705,7 @@ size of the heading, but not of keywords that were added to it, like  File: modus-themes.info, Node: UI typeface, Next: Headings' typeface, Prev: Scaled headings, Up: Customization Options -4.24 Option for variable-pitch font in UI elements +4.23 Option for variable-pitch font in UI elements ================================================== Symbol: ‘modus-themes-variable-pitch-ui’ @@ -1799,7 +1732,7 @@ Org and others (DIY).  File: modus-themes.info, Node: Headings' typeface, Prev: UI typeface, Up: Customization Options -4.25 Option for variable-pitch font in headings +4.24 Option for variable-pitch font in headings =============================================== Symbol: ‘modus-themes-variable-pitch-headings’ @@ -4916,7 +4849,6 @@ B.2 Variable index * modus-themes-operandi-color-overrides: Override colors (DIY). (line 6) * modus-themes-org-agenda: Org agenda. (line 6) * modus-themes-org-blocks: Org mode blocks. (line 6) -* modus-themes-org-habit: Org agenda habits. (line 6) * modus-themes-paren-match: Matching parentheses. (line 6) * modus-themes-prompts: Command prompts. (line 6) * modus-themes-region: Active region. (line 6) @@ -4990,102 +4922,101 @@ B.3 Concept index  Tag Table: Node: Top860 -Node: Overview6930 -Node: How do the themes look like8473 -Node: Learn about the latest changes8981 -Node: Installation9363 -Node: Install manually from source9844 -Node: Install from the archives10669 -Node: Install on GNU/Linux11446 -Node: Debian 11 Bullseye11894 -Node: GNU Guix12204 -Node: Enable and load12487 -Node: Sample configuration for use-package15476 -Node: Differences between loading and enabling16854 -Node: Customization Options18894 -Node: Custom reload theme25398 -Node: Success' color-code25959 -Node: Bold constructs26896 -Node: Italic constructs27685 -Node: Syntax styles28403 -Node: No mixed fonts30476 -Node: Link styles31571 -Node: Command prompts33982 -Node: Mode line35715 -Node: Completion UIs39260 -Node: Mail citations41131 -Node: Fringes41984 -Node: Language checkers42646 -Node: Line highlighting44707 -Node: Line numbers46262 -Node: Matching parentheses47340 -Node: Active region48672 -Node: Diffs50041 -Node: Org mode blocks51980 -Node: Org agenda53858 -Node: Org agenda habits59485 -Node: Heading styles61451 -Node: Scaled headings64540 -Node: Scaled heading sizes65143 -Node: UI typeface68399 -Node: Headings' typeface69245 -Node: Advanced customization (do-it-yourself)69869 -Node: Per-theme customization settings (DIY)71274 -Node: Case-by-case face specs using the themes' palette (DIY)72620 -Node: Face specs at scale using the themes' palette (DIY)77084 -Node: Remap face with local value (DIY)81901 -Node: Cycle through arbitrary colors (DIY)84426 -Node: Override colors (DIY)90992 -Node: Override color saturation (DIY)95885 -Node: Font configurations for Org and others (DIY)101638 -Ref: Font configurations for Org and others (DIY)-Footnote-1104286 -Node: Configure bold and italic faces (DIY)104473 -Node: Custom Org user faces (DIY)108519 -Node: Update Org block delimiter fontification (DIY)112275 -Node: Measure color contrast (DIY)114235 -Node: Load theme depending on time of day (DIY)117029 -Node: Backdrop for pdf-tools (DIY)118069 -Node: A theme-agnostic hook for theme loading (DIY)120858 -Node: Face coverage123248 -Node: Supported packages123717 -Node: Indirectly covered packages130520 -Node: Notes on individual packages131074 -Node: Note on avy hints132063 -Node: Note on calendarel weekday and weekend colors133231 -Node: Note on underlines in compilation buffers134414 -Node: Note on inline Latex in Org buffers135263 -Node: Note on dimmerel135873 -Node: Note on display-fill-column-indicator-mode137358 -Node: Note on mmm-modeel background colors138979 -Node: Note for prism141358 -Node: Note for god-mode144584 -Node: Note on company-mode overlay pop-up146256 -Ref: Note on company-mode overlay pop-up-Footnote-1146946 -Ref: Note on company-mode overlay pop-up-Footnote-2147013 -Node: Note on ERC escaped color sequences147068 -Ref: Note on ERC escaped color sequences-Footnote-1148496 -Node: Note on powerline or spaceline148606 -Node: Note on SHR colors149020 -Node: Note on EWW and Elfeed fonts (SHR fonts)149455 -Node: Note on Helm grep150200 -Node: Note on vc-annotate-background-mode151687 -Node: Note on pdf-tools link hints152572 -Node: Frequently Asked Questions (FAQ)155004 -Node: Is the contrast ratio about adjacent colors?155578 -Node: What does it mean to avoid exaggerations?157091 -Node: Why are colors mostly variants of blue magenta cyan?158926 -Node: What is the best setup for legibility?163273 -Node: Contributing165880 -Node: Sources of the themes166283 -Node: Issues you can help with167021 -Node: Patches require copyright assignment to the FSF168221 -Node: Acknowledgements170516 -Node: Meta173057 -Node: GNU Free Documentation License175054 -Node: Indices200406 -Node: Function index200585 -Node: Variable index201822 -Node: Concept index204036 +Node: Overview6838 +Node: How do the themes look like8381 +Node: Learn about the latest changes8889 +Node: Installation9271 +Node: Install manually from source9752 +Node: Install from the archives10577 +Node: Install on GNU/Linux11354 +Node: Debian 11 Bullseye11802 +Node: GNU Guix12112 +Node: Enable and load12395 +Node: Sample configuration for use-package15384 +Node: Differences between loading and enabling16762 +Node: Customization Options18802 +Node: Custom reload theme25214 +Node: Success' color-code25749 +Node: Bold constructs26686 +Node: Italic constructs27475 +Node: Syntax styles28193 +Node: No mixed fonts30226 +Node: Link styles31321 +Node: Command prompts33692 +Node: Mode line35385 +Node: Completion UIs38890 +Node: Mail citations40761 +Node: Fringes41614 +Node: Language checkers42276 +Node: Line highlighting44297 +Node: Line numbers45812 +Node: Matching parentheses46890 +Node: Active region48182 +Node: Diffs49511 +Node: Org mode blocks51450 +Node: Org agenda53328 +Node: Heading styles58820 +Node: Scaled headings61862 +Node: Scaled heading sizes62465 +Node: UI typeface65721 +Node: Headings' typeface66567 +Node: Advanced customization (do-it-yourself)67191 +Node: Per-theme customization settings (DIY)68596 +Node: Case-by-case face specs using the themes' palette (DIY)69942 +Node: Face specs at scale using the themes' palette (DIY)74406 +Node: Remap face with local value (DIY)79223 +Node: Cycle through arbitrary colors (DIY)81748 +Node: Override colors (DIY)88314 +Node: Override color saturation (DIY)93207 +Node: Font configurations for Org and others (DIY)98960 +Ref: Font configurations for Org and others (DIY)-Footnote-1101608 +Node: Configure bold and italic faces (DIY)101795 +Node: Custom Org user faces (DIY)105841 +Node: Update Org block delimiter fontification (DIY)109597 +Node: Measure color contrast (DIY)111557 +Node: Load theme depending on time of day (DIY)114351 +Node: Backdrop for pdf-tools (DIY)115391 +Node: A theme-agnostic hook for theme loading (DIY)118180 +Node: Face coverage120570 +Node: Supported packages121039 +Node: Indirectly covered packages127842 +Node: Notes on individual packages128396 +Node: Note on avy hints129385 +Node: Note on calendarel weekday and weekend colors130553 +Node: Note on underlines in compilation buffers131736 +Node: Note on inline Latex in Org buffers132585 +Node: Note on dimmerel133195 +Node: Note on display-fill-column-indicator-mode134680 +Node: Note on mmm-modeel background colors136301 +Node: Note for prism138680 +Node: Note for god-mode141906 +Node: Note on company-mode overlay pop-up143578 +Ref: Note on company-mode overlay pop-up-Footnote-1144268 +Ref: Note on company-mode overlay pop-up-Footnote-2144335 +Node: Note on ERC escaped color sequences144390 +Ref: Note on ERC escaped color sequences-Footnote-1145818 +Node: Note on powerline or spaceline145928 +Node: Note on SHR colors146342 +Node: Note on EWW and Elfeed fonts (SHR fonts)146777 +Node: Note on Helm grep147522 +Node: Note on vc-annotate-background-mode149009 +Node: Note on pdf-tools link hints149894 +Node: Frequently Asked Questions (FAQ)152326 +Node: Is the contrast ratio about adjacent colors?152900 +Node: What does it mean to avoid exaggerations?154413 +Node: Why are colors mostly variants of blue magenta cyan?156248 +Node: What is the best setup for legibility?160595 +Node: Contributing163202 +Node: Sources of the themes163605 +Node: Issues you can help with164343 +Node: Patches require copyright assignment to the FSF165543 +Node: Acknowledgements167838 +Node: Meta170379 +Node: GNU Free Documentation License172376 +Node: Indices197728 +Node: Function index197907 +Node: Variable index199144 +Node: Concept index201285  End Tag Table diff --git a/doc/modus-themes.org b/doc/modus-themes.org index 0b0261b..5bb230f 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 1.4.0 -#+macro: release-date 2021-05-25 -#+macro: development-version 1.5.0-dev +#+macro: stable-version 1.5.0 +#+macro: release-date 2021-07-15 +#+macro: development-version 1.6.0-dev #+macro: file @@texinfo:@file{@@$1@@texinfo:}@@ #+macro: space @@texinfo:@: @@ #+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@ @@ -469,8 +469,6 @@ this manual. :end: #+vindex: modus-themes-inhibit-reload -[ Part of {{{development-version}}} ] - Symbol: ~modus-themes-inhibit-reload~ Possible values: @@ -576,8 +574,6 @@ Advanced users may also want to configure the exact attributes of the :end: #+vindex: modus-themes-syntax -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-syntax~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -670,8 +666,6 @@ are ~org-variable-pitch~ and ~mixed-pitch~. :end: #+vindex: modus-themes-links -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-links~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -743,8 +737,6 @@ their documentation strings. :end: #+vindex: modus-themes-prompts -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-prompts~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -801,8 +793,6 @@ In user configuration files the form may look like this: :end: #+vindex: modus-themes-mode-line -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-mode-line~ Possible values, which can be expressed as a list of combinations of box @@ -984,8 +974,6 @@ names imply. :end: #+vindex: modus-themes-lang-checkers -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-lang-checkers~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -1046,8 +1034,6 @@ style, is controlled by the built-in variables ~underline-minimum-offset~, :end: #+vindex: modus-themes-hl-line -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-hl-line~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -1129,8 +1115,6 @@ updated to accommodate this aesthetic. :end: #+vindex: modus-themes-paren-match -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-paren-match~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -1178,8 +1162,6 @@ This customization variable affects the built-in ~show-paren-mode~ and the :end: #+vindex: modus-themes-region -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-region~ Possible values are expressed as a list of properties (default is ~nil~ or @@ -1313,9 +1295,6 @@ and ~rainbow~. Those will continue to work as they are aliases for :end: #+vindex: modus-themes-org-agenda -[ Part of {{{development-version}}}. Supersedes ~modus-themes-org-habit~ -([[#h:cf261363-d227-4717-ba3a-8171584030a7][Option for org-habit graph styles]]). ] - Symbol: ~modus-themes-org-agenda~ This is an alist that accepts a =(key . value)= combination. Some values @@ -1448,50 +1427,6 @@ Putting it all together, the alist can look like this: (habit . traffic-light))) #+end_src -** Option for org-habit graph styles -:properties: -:alt_title: Org agenda habits -:description: Choose among standard, simplified, or traffic light styles -:custom_id: h:cf261363-d227-4717-ba3a-8171584030a7 -:end: -#+vindex: modus-themes-org-habit - -[ Deprecated and superseded by ~modus-themes-org-agenda~ in -{{{development-version}}} ([[#h:68f481bc-5904-4725-a3e6-d7ecfa7c3dbc][Option for Org agenda constructs]]). ] - -Symbol: ~modus-themes-org-habit~ - -Possible values: - -1. ~nil~ (default) -2. ~simplified~ -3. ~traffic-light~ - -The default is meant to conform with the original aesthetic of -=org-habit=. It employs all four color codes that correspond to the -org-habit states---clear, ready, alert, and overdue---while -distinguishing between their present and future variants. This results -in a total of eight colors in use: red, yellow, green, blue, in tinted -and shaded versions. They cover the full set of information provided by -the =org-habit= consistency graph. - -Option ~simplified~ is like the default except that it removes the -dichotomy between current and future variants by applying uniform -color-coded values. It applies a total of four colors: red, yellow, -green, blue. They produce a simplified consistency graph that is more -legible (or less "busy") than the default. The intent is to shift focus -towards the distinction between the four states of a habit task, rather -than each state's present/future outlook. - -Option ~traffic-light~ further reduces the available colors to red, -yellow, and green. As in ~simplified~, present and future variants appear -uniformly, but differently from it, the 'clear' state is rendered in a -green hue, instead of the original blue. This is meant to capture the -use-case where a habit task being "too early" is less important than it -being "too late". The difference between ready and clear states is -attenuated by painting both of them using shades of green. This option -thus highlights the alert and overdue states. - ** Option for the headings' overall style :properties: :alt_title: Heading styles @@ -1500,8 +1435,6 @@ thus highlights the alert and overdue states. :end: #+vindex: modus-themes-headings -[ Refactored as part of {{{development-version}}} ] - Symbol: ~modus-themes-headings~ This is an alist that accepts a =(key . list-of-values)= combination. The diff --git a/modus-operandi-theme.el b/modus-operandi-theme.el index cd73681..a946d74 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: 1.4.0 +;; Version: 1.5.0 ;; Package-Requires: ((emacs "26.1")) ;; Keywords: faces, theme, accessibility diff --git a/modus-themes.el b/modus-themes.el index 8746269..b9fe4a3 100644 --- a/modus-themes.el +++ b/modus-themes.el @@ -4,8 +4,8 @@ ;; Author: Protesilaos Stavrou ;; URL: https://gitlab.com/protesilaos/modus-themes -;; Version: 1.4.0 -;; Last-Modified: <2021-07-15 13:18:36 +0300> +;; Version: 1.5.0 +;; Last-Modified: <2021-07-15 13:21:55 +0300> ;; Package-Requires: ((emacs "26.1")) ;; Keywords: faces, theme, accessibility diff --git a/modus-vivendi-theme.el b/modus-vivendi-theme.el index fa8ba21..6ff359d 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: 1.4.0 +;; Version: 1.5.0 ;; Package-Requires: ((emacs "26.1")) ;; Keywords: faces, theme, accessibility