branch: externals/modus-themes
commit 7cc3d1495daf7b55f97d34bd23407b538fb94387
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Fix some typos in the manual
---
doc/modus-themes.info | 464 ++++++++++++++++++++++++++------------------------
doc/modus-themes.org | 8 +-
2 files changed, 250 insertions(+), 222 deletions(-)
diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 966fa987d1..c2d294bbd0 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -171,7 +171,7 @@ DIY Stylistic variants using palette overrides
* DIY Make Org agenda more or less colorful::
* DIY Make inline code in prose use alternative styles::
* DIY Make mail citations and headers more or less colorful::
-* DIY Make the region preserve text colors, plus other styles: DIY Make the
region preserve text colors plus other styles.
+* DIY Make the region preserve text colors, plus other styles::
* DIY Make mouse highlights more or less colorful::
* DIY Make language underlines less colorful::
* DIY Make line numbers use alternative styles::
@@ -213,7 +213,7 @@ Frequently Asked Questions
* Is the contrast ratio about adjacent colors?::
* What does it mean to avoid exaggerations?::
-* Why are colors mostly variants of blue, magenta, cyan?: Why are colors
mostly variants of blue magenta cyan?.
+* Why are colors mostly variants of blue, magenta, cyan?::
* What is the best setup for legibility?::
* Are these color schemes?::
* Port the Modus themes to other platforms?::
@@ -282,7 +282,7 @@ Tritanopia themes
To ensure that users have a consistently accessible experience, the
themes strive to achieve as close to full face coverage as possible,
while still targeting a curated list of well-maintained packages (*note
-Face coverage::).
+Face coverage: Face coverage.).
The overarching objective of this project is to always offer
accessible color combinations. There shall never be a compromise on
@@ -306,7 +306,8 @@ File: modus-themes.info, Node: How do the themes look
like, Next: Learn about
Check the web page with the screen shots
(https://protesilaos.com/emacs/modus-themes-pictures/). Note that the
-themes are highly customizable (*note Customization options::).
+themes are highly customizable (*note Customization options:
+Customization options.).
File: modus-themes.info, Node: Learn about the latest changes, Prev: How do
the themes look like, Up: Overview
@@ -364,7 +365,8 @@ stored in ‘~/.emacs.d’ and that you want to place the Modus
themes in
(add-to-list 'load-path "~/.emacs.d/modus-themes")
- The themes are now ready to be used: *note Enable and load::.
+ The themes are now ready to be used: *note Enable and load: Enable
+and load.
File: modus-themes.info, Node: Install from the archives, Next: Install on
GNU/Linux, Prev: Install manually from source, Up: Installation
@@ -380,7 +382,7 @@ with ‘M-x package-refresh-contents’. Then all you need to
do is type
‘M-x package-install’ and specify the ‘modus-themes’.
Once installed, the themes are ready to be used: *note Enable and
-load::.
+load: Enable and load.
File: modus-themes.info, Node: Install on GNU/Linux, Next: Dealing with byte
compilation errors, Prev: Install from the archives, Up: Installation
@@ -408,7 +410,8 @@ The themes are part of Debian 11 Bullseye. Get them with:
sudo apt install elpa-modus-themes
- They are now ready to be used: *note Enable and load::.
+ They are now ready to be used: *note Enable and load: Enable and
+load.
NOTE that Debian’s package is severely out-of-date as of this writing
2022-07-24 09:57 +0300.
@@ -423,7 +426,8 @@ Users of Guix can get the themes with this command:
guix package -i emacs-modus-themes
- They are now ready to be used: *note Enable and load::.
+ They are now ready to be used: *note Enable and load: Enable and
+load.
File: modus-themes.info, Node: Dealing with byte compilation errors, Prev:
Install on GNU/Linux, Up: Installation
@@ -452,7 +456,7 @@ the relevant upstream maintainer. Whatever you do, please
understand
that a build failure does not mean we are necessarily doing something
wrong.
- *note Issues you can help with::.
+ *note Issues you can help with: Issues you can help with.
File: modus-themes.info, Node: Enable and load, Next: Customization options,
Prev: Installation, Up: Top
@@ -474,8 +478,8 @@ of their preference by adding either form to their init
file:
(load-theme 'modus-operandi) ; Light theme
(load-theme 'modus-vivendi) ; Dark theme
- Remember that there are multiple Modus themes (*note Overview::).
-Adapt the above snippet accordingly.
+ Remember that there are multiple Modus themes (*note Overview:
+Overview.). Adapt the above snippet accordingly.
Users of packaged variants of the themes must add a few more lines to
ensure that everything works as intended. First, one has to require the
@@ -525,7 +529,8 @@ themes.):
(define-key global-map (kbd "<f5>") #'modus-themes-toggle)
- *note Sample configuration with and without use-package::.
+ *note Sample configuration with and without use-package: Sample
+configuration with and without use-package.
To disable other themes before loading a Modus theme, use something
like this:
@@ -544,12 +549,13 @@ the user opts in (*note Option for disabling other themes
while loading
Modus: Disable other themes.). After loading the theme of choice, this
function calls the hook ‘modus-themes-after-load-theme-hook’ (alias
‘modus-themes-post-load-hook’). Users can add their own functions to
-this hook to make further customizations (*note Advanced
-customization::).
+this hook to make further customizations (*note Advanced customization:
+Advanced customization.).
The commands ‘modus-themes-toggle’ and ‘modus-themes-select’ use
‘modus-themes-load-theme’ internally (*note Option for which themes to
-toggle::). The aforementioned hold true for them as well.
+toggle: Option for which themes to toggle.). The aforementioned hold
+true for them as well.
* Menu:
@@ -591,7 +597,7 @@ File: modus-themes.info, Node: Sample configuration with
and without use-packag
=====================================================
What follows is a variant of what we demonstrate in the previous section
-(*note Enable and load::).
+(*note Enable and load: Enable and load.).
It is common for Emacs users to rely on ‘use-package’ for declaring
package configurations in their setup. We use this as an example:
@@ -650,7 +656,8 @@ package configurations in their setup. We use this as an
example:
(define-key global-map (kbd "<f5>") #'modus-themes-toggle)
- *note Differences between loading and enabling::.
+ *note Differences between loading and enabling: Differences between
+loading and enabling.
Note: make sure not to customize the variable
‘custom-theme-load-path’ or ‘custom-theme-directory’ after the themes’
@@ -698,7 +705,8 @@ session, are better off using something like this:
*note Toggle themes without reloading them: DIY Toggle themes without
reloading them.
- *note Sample configuration with and without use-package::.
+ *note Sample configuration with and without use-package: Sample
+configuration with and without use-package.
With the above granted, other sections of the manual discuss how to
configure custom faces, where ‘load-theme’ is expected, though
@@ -723,8 +731,8 @@ everything at length in the pages of this manual and also
provide
ready-to-use code samples.
Remember that all customization options must be evaluated before
-loading a theme (*note Enable and load::). If the theme is already
-active, it must be reloaded for changes to take effect.
+loading a theme (*note Enable and load: Enable and load.). If the theme
+is already active, it must be reloaded for changes to take effect.
;; In all of the following, WEIGHT is a symbol such as `semibold',
;; `light', `bold', or anything mentioned in `modus-themes-weights'.
@@ -810,7 +818,7 @@ Custom UI or related functions such as
‘customize-set-variable’ and
With a ‘nil’ value, changes to user options have no further
consequences: the user must manually reload the theme (*note Enable and
-load::).
+load: Enable and load.).
File: modus-themes.info, Node: Disable other themes, Next: Bold constructs,
Prev: Custom reload theme, Up: Customization options
@@ -830,9 +838,10 @@ Brief: Disable all other themes when loading a Modus theme.
When the value is non-‘nil’, the commands ‘modus-themes-toggle’ and
‘modus-themes-select’, as well as the ‘modus-themes-load-theme’
function, will disable all other themes while loading the specified
-Modus theme (*note Option for which themes to toggle::). This is done
-to ensure that Emacs does not blend two or more themes: such blends lead
-to awkward results that undermine the work of the designer.
+Modus theme (*note Option for which themes to toggle: Option for which
+themes to toggle.). This is done to ensure that Emacs does not blend
+two or more themes: such blends lead to awkward results that undermine
+the work of the designer.
When the value is ‘nil’, the aforementioned commands and function
will only disable other themes within the Modus collection.
@@ -1108,11 +1117,12 @@ File: modus-themes.info, Node: Org mode blocks, Next:
Heading styles, Prev: C
As part of version ‘4.4.0’, the ‘modus-themes-org-blocks’ is no more.
Users can apply palette overrides to set a style that fits their
preference (purple, blue, yellow, green, etc.). It is more flexible and
-more powerful (*note DIY Make Org block colors more or less colorful::)
+more powerful (*note DIY Make Org block colors more or less colorful:
+DIY Make Org block colors more or less colorful.)
For the option to change the background of Org source blocks, we
provide the relevant setup (*note DIY Use colored Org source blocks per
-language::).
+language: DIY Use colored Org source blocks per language.).
File: modus-themes.info, Node: Heading styles, Next: UI typeface, Prev: Org
mode blocks, Up: Customization options
@@ -1356,8 +1366,9 @@ cyan hue to keywords:
(comment red-faint)
(keyword cyan-cooler)))
- Changes take effect upon theme reload (*note Custom reload theme::).
-Overrides are removed by setting their variable to a ‘nil’ value.
+ Changes take effect upon theme reload (*note Custom reload theme:
+Custom reload theme.). Overrides are removed by setting their variable
+to a ‘nil’ value.
The common accented foregrounds in each palette follow a predictable
naming scheme: ‘HUE{,-warmer,-cooler,-faint,-intense}’. ‘HUE’ is one of
@@ -1369,7 +1380,8 @@ that are meant to be combined with such backgrounds,
contain ‘fg’ in
their name, such as ‘fg-removed’ which complements ‘bg-removed’.
Named colors can be previewed, such as with the command
-‘modus-themes-list-colors’ (*note Preview theme colors::).
+‘modus-themes-list-colors’ (*note Preview theme colors: Preview theme
+colors.).
For a video tutorial that users of all skill levels can approach,
watch:
@@ -1468,7 +1480,7 @@ bindings), these commands will show a preview of the
palette’s semantic
color mappings instead of the full palette (*note Option for palette
overrides: Palette overrides.).
- Aliases for these commands are ‘modus-themes-preview-colors’ and
+ Aliases for those commands are ‘modus-themes-preview-colors’ and
‘modus-themes-preview-colors-current’.
Each row includes a foreground and background rendition of the given
@@ -1491,15 +1503,17 @@ File: modus-themes.info, Node: Use colors from the
Modus themes palette, Next:
The Modus themes provide the means to access the palette of (i) the
active theme or (ii) any theme in the Modus collection. These are
-useful for Do-It-Yourself customizations (*note Advanced
-customization::), though it can also be helpful in other cases, such as
-to reuse a color value in some other application.
+useful for Do-It-Yourself customizations (*note Advanced customization:
+Advanced customization.), though it can also be helpful in other cases,
+such as to reuse a color value in some other application.
Function
*note Get a single color from the palette with
- modus-themes-get-color-value::
+ ‘modus-themes-get-color-value’: Get a single color from the palette
+ with modus-themes-get-color-value.
Macro
- *note Use theme colors in code with modus-themes-with-colors::.
+ *note Use theme colors in code with ‘modus-themes-with-colors’: Use
+ theme colors in code with modus-themes-with-colors.
* Menu:
@@ -1512,13 +1526,13 @@ File: modus-themes.info, Node: Get a single color from
the palette with modus-t
6.1 Get a single color from the palette with ‘modus-themes-get-color-value’
===========================================================================
-The fuction ‘modus-themes-get-color-value’ can be called from Lisp to
+The function ‘modus-themes-get-color-value’ can be called from Lisp to
return the value of a color from the active Modus theme palette. It
takea a ‘COLOR’ argument and an optional ‘OVERRIDES’. It also accepts a
third ‘THEME’ argument, to get the color from the given theme.
‘COLOR’ is a symbol that represents a named color entry in the
-palette (*note Preview theme colors::).
+palette (*note Preview theme colors: Preview theme colors.).
If the value is the name of another color entry in the palette (so a
mapping), this function recurs until it finds the underlying color
@@ -1583,8 +1597,8 @@ of it. For example:
The above return value is for ‘modus-operandi’ when that is the
active theme. Switching to another theme and evaluating this code anew
will return the relevant results for that theme (remember that since
-version 4, the Modus themes consist of many items (*note Overview::)).
-The same with ‘modus-vivendi’ as the active theme:
+version 4, the Modus themes consist of many items (*note Overview:
+Overview.)). The same with ‘modus-vivendi’ as the active theme:
(modus-themes-with-colors
(list blue-warmer magenta-cooler fg-added warning variable
fg-heading-4))
@@ -1593,12 +1607,14 @@ The same with ‘modus-vivendi’ as the active theme:
The ‘modus-themes-with-colors’ has access to the whole palette of the
active theme, meaning that it can instantiate both (i) named colors like
‘blue-warmer’ and (ii) semantic color mappings like ‘warning’. We
-provide commands to inspect those (*note Preview theme colors::).
+provide commands to inspect those (*note Preview theme colors: Preview
+theme colors.).
Others sections in this manual show how to use the aforementioned
-macro (*note Advanced customization::). In practice, the use of a hook
-will also be needed (*note DIY Use a hook at the post-load-theme
-phase::).
+macro (*note Advanced customization: Advanced customization.). In
+practice, the use of a hook will also be needed (*note DIY Use a hook at
+the post-load-theme phase: DIY Use a hook at the post-load-theme
+phase.).
File: modus-themes.info, Node: Advanced customization, Next: Face coverage,
Prev: Use colors from the Modus themes palette, Up: Top
@@ -1721,7 +1737,7 @@ changes to use the colors of the active Modus theme.
defines to the corresponding entry in the palette of the active Modus
theme. We then use a hook to ensure that the value is updated after we
switch to another theme in the collection (*note DIY Use a hook at the
-post-load-theme phase::).
+post-load-theme phase: DIY Use a hook at the post-load-theme phase.).
(defun my-modus-themes-engraved-faces (&rest _)
(modus-themes-with-colors
@@ -1836,7 +1852,7 @@ Palette override presets: DIY Palette override presets.).
* DIY Make Org agenda more or less colorful::
* DIY Make inline code in prose use alternative styles::
* DIY Make mail citations and headers more or less colorful::
-* DIY Make the region preserve text colors, plus other styles: DIY Make the
region preserve text colors plus other styles.
+* DIY Make the region preserve text colors, plus other styles::
* DIY Make mouse highlights more or less colorful::
* DIY Make language underlines less colorful::
* DIY Make line numbers use alternative styles::
@@ -2545,7 +2561,8 @@ nice combinations:
(fg-prose-block-delimiter cyan-cooler)))
[ Combine the above with a suitable mode line style for maximum
-effect (*note DIY Make the active mode line colorful::). ]
+effect (*note DIY Make the active mode line colorful: DIY Make the
+active mode line colorful.). ]
Finally, the following makes code blocks have no distinct background.
The minimal styles are applied to the delimiter lines, which only use a
@@ -2561,7 +2578,8 @@ until version 4.3.0.
(bg-prose-block-delimiter unspeficied)
(fg-prose-block-delimiter fg-dim)))
- *note DIY Use colored Org source blocks per language::.
+ *note DIY Use colored Org source blocks per language: DIY Use colored
+Org source blocks per language.
File: modus-themes.info, Node: DIY Make Org agenda more or less colorful,
Next: DIY Make inline code in prose use alternative styles, Prev: DIY Make Org
block colors more or less colorful, Up: DIY Stylistic variants using palette
overrides
@@ -2649,7 +2667,8 @@ permutation.
• *note Make TODO and DONE more or less intense: DIY Make TODO and
DONE more or less intense.
- • *note DIY Make Org block colors more or less colorful::.
+ • *note DIY Make Org block colors more or less colorful: DIY Make Org
+ block colors more or less colorful.
;; A nuanced accented background, combined with a suitable foreground.
(setq modus-themes-common-palette-overrides
@@ -2687,7 +2706,7 @@ permutation.
Reload the theme for changes to take effect.
-File: modus-themes.info, Node: DIY Make mail citations and headers more or
less colorful, Next: DIY Make the region preserve text colors plus other
styles, Prev: DIY Make inline code in prose use alternative styles, Up: DIY
Stylistic variants using palette overrides
+File: modus-themes.info, Node: DIY Make mail citations and headers more or
less colorful, Next: DIY Make the region preserve text colors, plus other
styles, Prev: DIY Make inline code in prose use alternative styles, Up: DIY
Stylistic variants using palette overrides
7.3.18 DIY Make mail citations and headers more or less colorful
----------------------------------------------------------------
@@ -2746,7 +2765,7 @@ Before we show the code, this is the anatomy of a message:
Reload the theme for changes to take effect.
-File: modus-themes.info, Node: DIY Make the region preserve text colors plus
other styles, Next: DIY Make mouse highlights more or less colorful, Prev:
DIY Make mail citations and headers more or less colorful, Up: DIY Stylistic
variants using palette overrides
+File: modus-themes.info, Node: DIY Make the region preserve text colors, plus
other styles, Next: DIY Make mouse highlights more or less colorful, Prev:
DIY Make mail citations and headers more or less colorful, Up: DIY Stylistic
variants using palette overrides
7.3.19 DIY Make the region preserve text colors, plus other styles
------------------------------------------------------------------
@@ -2780,7 +2799,7 @@ region background.
Reload the theme for changes to take effect.
-File: modus-themes.info, Node: DIY Make mouse highlights more or less
colorful, Next: DIY Make language underlines less colorful, Prev: DIY Make
the region preserve text colors plus other styles, Up: DIY Stylistic variants
using palette overrides
+File: modus-themes.info, Node: DIY Make mouse highlights more or less
colorful, Next: DIY Make language underlines less colorful, Prev: DIY Make
the region preserve text colors, plus other styles, Up: DIY Stylistic variants
using palette overrides
7.3.20 DIY Make mouse highlights more or less colorful
------------------------------------------------------
@@ -3031,8 +3050,8 @@ the background). It thus falls back to the closest
approximation, which
seldom is appropriate for the purposes of the Modus themes.
In such a case, the user is expected to update their terminal’s color
-palette such as by adapting these resources (*note Preview theme
-colors::):
+palette such as by adapting these resources (*note Preview theme colors:
+Preview theme colors.):
! Theme: modus-operandi
! Description: XTerm port of modus-operandi (Modus themes for GNU Emacs)
@@ -3120,17 +3139,17 @@ File: modus-themes.info, Node: DIY Do not extend the
region background, Next:
7.7 DIY Do not extend the region background
===========================================
-By the default, the background of the ‘region’ face extends from the end
-of the line to the edge of the window. To limit it to the end of the
-line, we need to override the face’s ‘:extend’ attribute. Adding this
-to the Emacs configuration file will suffice:
+By default, the background of the ‘region’ face extends from the end of
+the line to the edge of the window. To limit it to the end of the line,
+we need to override the face’s ‘:extend’ attribute. Adding this to the
+Emacs configuration file will suffice:
;; Do not extend `region' background past the end of the line.
(custom-set-faces
'(region ((t :extend nil))))
*note Make the region preserve text colors, plus other styles: DIY
-Make the region preserve text colors plus other styles.
+Make the region preserve text colors, plus other styles.
File: modus-themes.info, Node: DIY Add padding to the mode line, Next: DIY
Remap face with local value, Prev: DIY Do not extend the region background,
Up: Advanced customization
@@ -3389,10 +3408,11 @@ pick fonts that work well together):
To ensure that the effects persist after switching between the Modus
themes (such as with ‘M-x modus-themes-toggle’), the user needs to write
their configurations to a function and pass it to the
-‘modus-themes-after-load-theme-hook’ (*note Enable and load::). This is
-necessary because themes set the styles of faces upon activation,
-overriding prior values where conflicts occur between the previous and
-the current states (otherwise changing themes would not be possible).
+‘modus-themes-after-load-theme-hook’ (*note Enable and load: Enable and
+load.). This is necessary because themes set the styles of faces upon
+activation, overriding prior values where conflicts occur between the
+previous and the current states (otherwise changing themes would not be
+possible).
*note A theme-agnostic hook for theme loading: DIY A theme-agnostic
hook for theme loading.
@@ -3639,7 +3659,8 @@ File: modus-themes.info, Node: DIY Use colored Org
source blocks per language,
7.14 DIY Use colored Org source blocks per language
===================================================
-*note DIY Make Org block colors more or less colorful::.
+*note DIY Make Org block colors more or less colorful: DIY Make Org
+block colors more or less colorful.
In versions of the Modus themes before ‘4.4.0’ there was an option to
change the coloration of Org source blocks so that certain languages
@@ -3681,7 +3702,8 @@ mechanism provided by the Modus themes. ]
(add-hook 'modus-themes-after-load-theme-hook
#'my-modus-themes-org-block-faces)
- *note DIY Use a hook at the post-load-theme phase::.
+ *note DIY Use a hook at the post-load-theme phase: DIY Use a hook at
+the post-load-theme phase.
Note that the ‘org-src-block-faces’ accepts a named face, as shown
above, as well as a list of face attributes. The latter approach is not
@@ -3847,7 +3869,7 @@ enough when you only use one theme. However it has the
downside of
setting the background color value only at render time. In other words,
the face remapping function does not get evaluated anew whenever the
theme changes, such as upon invoking ‘M-x modus-themes-toggle’ (*note
-Option for which themes to toggle::).
+Option for which themes to toggle: Option for which themes to toggle.).
To have our face remapping adapt gracefully while switching between
the Modus themes, we need to also account for the current theme and
@@ -3910,7 +3932,8 @@ their own command which calls ‘enable-theme’ instead of
‘load-theme’:
(disable-theme 'modus-vivendi)))
(_ (error "No Modus theme is loaded; evaluate
`modus-themes-load-themes' first"))))
- *note Differences between loading and enabling::.
+ *note Differences between loading and enabling: Differences between
+loading and enabling.
Recall that ‘modus-themes-toggle’ uses ‘load-theme’.
@@ -4086,7 +4109,7 @@ themes (or any other of my themes, for that matter).
Users who want it
must style the faces manually. Below is some sample code, based on what
we cover at length elsewhere in this manual:
- *note Advanced customization::.
+ *note Advanced customization: Advanced customization.
*note Use theme colors in code with modus-themes-with-colors: Use
theme colors in code with modus-themes-with-colors.
@@ -4201,7 +4224,8 @@ hook to apply the desired changes. In most examples,
this hook is the
themes and is called at the end of one the following:
Command ‘modus-themes-toggle’
- *note Option for which themes to toggle::.
+ *note Option for which themes to toggle: Option for which themes to
+ toggle.
Command ‘modus-themes-select’
Select a Modus theme using minibuffer completion and then load it.
@@ -4217,9 +4241,10 @@ Function ‘modus-themes-load-theme’
collection cannot benefit from the aforementioned hook: it only works
with the Modus themes. A theme-agnostic hook is needed in such a case.
Before Emacs 29, this had to be set up manually (*note DIY A
-theme-agnostic hook for theme loading::). Starting with Emacs 29, the
-special hook ‘enable-theme-functions’ works with anything that uses the
-basic ‘enable-theme’ function.
+theme-agnostic hook for theme loading: DIY A theme-agnostic hook for
+theme loading.). Starting with Emacs 29, the special hook
+‘enable-theme-functions’ works with anything that uses the basic
+‘enable-theme’ function.
To use the ‘enable-theme-functions’ just add the given function to it
the way it is done with every hook:
@@ -4725,7 +4750,7 @@ relevant faces to yield the desired color combinations.
local setup. Below is some sample code, based on what we cover at
length elsewhere in this manual:
- *note Advanced customization::.
+ *note Advanced customization: Advanced customization.
*note Use theme colors in code with modus-themes-with-colors: Use
theme colors in code with modus-themes-with-colors.
@@ -4904,7 +4929,7 @@ some of the techniques that are discussed at length in
the various
“Do-It-Yourself” (DIY) sections, which provide insight into the more
advanced customization options of the themes.
- *note Advanced customization::.
+ *note Advanced customization: Advanced customization.
In the following example, we are assuming that the user wants to (i)
reuse color variables provided by the themes, (ii) be able to retain
@@ -5244,7 +5269,7 @@ File: modus-themes.info, Node: Note on SHR fonts, Next:
Note on Ement colors a
9.15 Note on SHR fonts
======================
-By default, packages that build on top of the Simple HTML Remember
+By default, packages that build on top of the Simple HTML Renderer
(‘shr’) use proportionately spaced fonts. This is controlled by the
user option ‘shr-use-fonts’, which is set to non-‘nil’ by default. To
use the standard font instead, set that variable to ‘nil’.
@@ -5280,7 +5305,7 @@ which is slightly below our nominal target. Try this
instead:
(setq ement-room-prism-minimum-contrast 7)
With regard to fonts, Ement depends on ‘shr’ (*note Note on SHR
-fonts::).
+fonts: Note on SHR fonts.).
Since we are here, here is an excerpt from Ement’s source code:
@@ -5396,7 +5421,7 @@ themes’ design and application.
* Is the contrast ratio about adjacent colors?::
* What does it mean to avoid exaggerations?::
-* Why are colors mostly variants of blue, magenta, cyan?: Why are colors
mostly variants of blue magenta cyan?.
+* Why are colors mostly variants of blue, magenta, cyan?::
* What is the best setup for legibility?::
* Are these color schemes?::
* Port the Modus themes to other platforms?::
@@ -5430,7 +5455,7 @@ be colored differently. They would still be legible
though, which is
the primary objective of the Modus themes.
-File: modus-themes.info, Node: What does it mean to avoid exaggerations?,
Next: Why are colors mostly variants of blue magenta cyan?, Prev: Is the
contrast ratio about adjacent colors?, Up: Frequently Asked Questions
+File: modus-themes.info, Node: What does it mean to avoid exaggerations?,
Next: Why are colors mostly variants of blue, magenta, cyan?, Prev: Is the
contrast ratio about adjacent colors?, Up: Frequently Asked Questions
10.2 What does it mean to avoid exaggerations?
==============================================
@@ -5463,7 +5488,7 @@ magenta can suffice to tell things apart and avoid excess
coloration: a
harmonious rhythm.
-File: modus-themes.info, Node: Why are colors mostly variants of blue magenta
cyan?, Next: What is the best setup for legibility?, Prev: What does it mean
to avoid exaggerations?, Up: Frequently Asked Questions
+File: modus-themes.info, Node: Why are colors mostly variants of blue,
magenta, cyan?, Next: What is the best setup for legibility?, Prev: What does
it mean to avoid exaggerations?, Up: Frequently Asked Questions
10.3 Why are colors mostly variants of blue, magenta, cyan?
===========================================================
@@ -5473,7 +5498,8 @@ others for the accessibility purposes of the themes, the
stylistic
consistency between ‘modus-operandi’ and ‘modus-vivendi’, and the
avoidance of exaggerations in design.
- *note What does it mean to avoid exaggerations?::
+ *note What does it mean to avoid exaggerations?: What does it mean to
+avoid exaggerations?.
What we describe as color is a function of three distinct channels of
light: red, green, blue. In hexadecimal RGB notation, a color value is
@@ -5516,7 +5542,8 @@ adjacent colors, it is not possible to make red, green,
and yellow the
main colors, because blue cannot be used to control their luminance and,
thus the relevant space will shrink considerably.
- *note Is the contrast ratio about adjacent colors?::
+ *note Is the contrast ratio about adjacent colors?: Is the contrast
+ratio about adjacent colors?.
This phenomenon is best illustrated by the following table that
measures the relative luminance of shades of red, yellow, magenta
@@ -5551,7 +5578,7 @@ completely different than ‘modus-operandi’, to the effect
that the two
could not be properly considered part of the same project.
-File: modus-themes.info, Node: What is the best setup for legibility?, Next:
Are these color schemes?, Prev: Why are colors mostly variants of blue magenta
cyan?, Up: Frequently Asked Questions
+File: modus-themes.info, Node: What is the best setup for legibility?, Next:
Are these color schemes?, Prev: Why are colors mostly variants of blue,
magenta, cyan?, Up: Frequently Asked Questions
10.4 What is the best setup for legibility?
===========================================
@@ -5696,7 +5723,7 @@ For example, some of the customization options accept a
list as their
value, or an alist, which may not be possible to reproduce on other
platforms.
- *note Customization options::.
+ *note Customization options: Customization options.
In other words, if something must be done differently on a certain
editor then that is acceptable so long as (i) the accessibility
@@ -5708,12 +5735,12 @@ scientific foundations of the themes: high legibility
and taking care of
the needs of users with red-green/blue-yellow color deficiency
(deuteranopia and tritanopia) by avoiding red+green color coding
paradigms and/or by providing yellow+blue variants for deuteranopia and
-red+cyan for tritanopia (*note Overview::).
+red+cyan for tritanopia (*note Overview: Overview.).
The latter criterion is the “je ne sais quoi” of the artistic aspect
of the themes, which is partially fleshed out in this manual.
- *note Frequently Asked Questions::.
+ *note Frequently Asked Questions: Frequently Asked Questions.
With regard to the artistic aspect (where “art” qua skill may amount
to an imprecise science), there is no hard-and-fast rule in effect as it
@@ -5786,7 +5813,8 @@ modus-themes public mailing list
• Send patches for code refinements (if you need, ask me for help
with Git—we all start out as beginners).
- *note Patches require copyright assignment to the FSF::.
+ *note Patches require copyright assignment to the FSF: Patches
+require copyright assignment to the FSF.
It is preferable that your feedback includes some screenshots, GIFs,
or short videos, as well as further instructions to reproduce a given
@@ -6448,13 +6476,13 @@ B.1 Function index
(line 6)
* modus-themes-list-colors: Preview theme colors. (line 6)
* modus-themes-list-colors-current: Preview theme colors. (line 10)
-* modus-themes-load-theme: Enable and load. (line 79)
+* modus-themes-load-theme: Enable and load. (line 80)
* modus-themes-preview-colors: Preview theme colors. (line 18)
* modus-themes-preview-colors-current: Preview theme colors. (line 18)
* modus-themes-rotate: Option for which themes to rotate.
(line 6)
-* modus-themes-select: Enable and load. (line 93)
-* modus-themes-toggle: Enable and load. (line 93)
+* modus-themes-select: Enable and load. (line 94)
+* modus-themes-toggle: Enable and load. (line 94)
* modus-themes-toggle <1>: Option for which themes to toggle.
(line 6)
* modus-themes-wcag-formula: DIY Measure color contrast.
@@ -6481,7 +6509,7 @@ B.2 Variable index
* modus-operandi-tritanopia-palette-overrides: Palette overrides.
(line 34)
* modus-operandi-tritanopia-palette-user: Palette extension. (line 26)
-* modus-themes-after-load-theme-hook: Enable and load. (line 85)
+* modus-themes-after-load-theme-hook: Enable and load. (line 86)
* modus-themes-bold-constructs: Bold constructs. (line 6)
* modus-themes-common-palette-overrides: Palette overrides. (line 22)
* modus-themes-common-palette-user: Palette extension. (line 16)
@@ -6492,7 +6520,7 @@ B.2 Variable index
* modus-themes-italic-constructs: Italic constructs. (line 6)
* modus-themes-mixed-fonts: Mixed fonts. (line 6)
* modus-themes-org-blocks: Org mode blocks. (line 6)
-* modus-themes-post-load-hook: Enable and load. (line 85)
+* modus-themes-post-load-hook: Enable and load. (line 86)
* modus-themes-preset-overrides-cooler: DIY Palette override presets.
(line 29)
* modus-themes-preset-overrides-faint: DIY Palette override presets.
@@ -6553,7 +6581,7 @@ B.3 Concept index
(line 6)
* Implicitly supported packages: Indirectly covered packages.
(line 6)
-* Innate color qualities of the palette: Why are colors mostly variants of
blue magenta cyan?.
+* Innate color qualities of the palette: Why are colors mostly variants of
blue, magenta, cyan?.
(line 6)
* load-theme VS enable-theme: Differences between loading and
enabling.
(line 6)
@@ -6589,133 +6617,133 @@ B.3 Concept index
Tag Table:
Node: Top872
-Node: Overview8646
-Node: How do the themes look like11418
-Node: Learn about the latest changes11777
-Node: Installation12165
-Node: Install manually from source13095
-Node: Install from the archives13920
-Node: Install on GNU/Linux14519
-Node: Debian 11 Bullseye15012
-Node: GNU Guix15422
-Node: Dealing with byte compilation errors15705
-Node: Enable and load16863
-Node: The require-theme for built-in Emacs themes20807
-Node: Sample configuration with and without use-package21927
-Node: Differences between loading and enabling24775
-Node: Customization options26906
-Node: Custom reload theme30815
-Node: Disable other themes31735
-Node: Bold constructs32977
-Node: Italic constructs33849
-Node: Option for which themes to toggle34677
-Node: Option for which themes to rotate35440
-Node: Mixed fonts36216
-Node: Command prompts37270
-Node: Completion UIs39113
-Node: Org mode blocks41964
-Node: Heading styles42609
-Node: UI typeface47039
-Node: Palette overrides48012
-Node: Palette extension52402
-Node: Preview theme colors54878
-Node: Use colors from the Modus themes palette56434
-Node: Get a single color from the palette with
modus-themes-get-color-value57298
-Node: Use theme colors in code with modus-themes-with-colors59660
-Node: Advanced customization61916
-Node: DIY Palette override presets63683
-Node: DIY Add support for engrave-faces66525
-Node: DIY Stylistic variants using palette overrides76508
-Node: DIY Make the mode line borderless78567
-Node: DIY Make the active mode line colorful79942
-Node: DIY Make the tab bar more or less colorful82160
-Node: DIY Make the fringe invisible or another color84097
-Node: DIY Make links use subtle or no underlines85298
-Node: DIY Make prompts more or less colorful86416
-Node: DIY Make completion matches more or less colorful87739
-Node: DIY Make comments yellow and strings green91298
-Node: DIY Make code syntax use the old alt-syntax style93007
-Node: DIY Make use of alternative styles for code syntax96130
-Node: DIY Make matching parenthesis more or less intense99592
-Node: DIY Make box buttons more or less gray100964
-Node: DIY Make TODO and DONE more or less intense101977
-Node: DIY Make headings more or less colorful103478
-Node: DIY Make Org block colors more or less colorful105595
-Node: DIY Make Org agenda more or less colorful109969
-Node: DIY Make inline code in prose use alternative styles113144
-Node: DIY Make mail citations and headers more or less colorful115386
-Node: DIY Make the region preserve text colors plus other styles117786
-Node: DIY Make mouse highlights more or less colorful119342
-Node: DIY Make language underlines less colorful120355
-Node: DIY Make line numbers use alternative styles121507
-Node: DIY Make diffs use only a foreground123150
-Node: DIY Make deuteranopia diffs red and blue instead of yellow and
blue126041
-Node: DIY More accurate colors in terminal emulators128521
-Node: DIY Range of color with terminal emulators129833
-Node: DIY Per-theme customization settings132626
-Node: DIY Do not extend the region background134059
-Node: DIY Add padding to the mode line134863
-Node: DIY Remap face with local value137797
-Node: DIY Font configurations for Org and others140344
-Ref: DIY Font configurations for Org and others-Footnote-1143329
-Node: DIY Configure bold and italic faces143516
-Node: DIY Custom Org todo keyword and priority faces148138
-Node: DIY Custom Org emphasis faces151881
-Node: DIY Use colored Org source blocks per language156762
-Node: DIY Measure color contrast161402
-Node: DIY Load theme depending on time of day164122
-Node: DIY Backdrop for pdf-tools165152
-Node: DIY Toggle themes without reloading them168321
-Node: DIY Use more spacious margins or padding in Emacs frames169630
-Node: DIY Custom hl-todo colors173887
-Node: DIY Add support for solaire-mode175704
-Node: DIY Add support for meow-mode178810
-Node: DIY Add support for combobulate180620
-Node: DIY Use a hook at the post-load-theme phase184243
-Node: DIY A theme-agnostic hook for theme loading186366
-Node: Face coverage188997
-Node: Supported packages189449
-Node: Indirectly covered packages195270
-Node: Notes on individual packages196626
-Node: Note on calendarel weekday and weekend colors197726
-Node: Note on git-gutter in Doom Emacs198874
-Node: Note on php-mode multiline comments201374
-Node: Note on underlines in compilation buffers202134
-Node: Note on inline Latex in Org buffers203006
-Node: Note on dimmerel203616
-Node: Note on display-fill-column-indicator-mode205101
-Node: Note on highlight-parenthesesel206554
-Node: Note on mmm-modeel background colors212635
-Node: Note for prism214989
-Node: Note on company-mode overlay pop-up218211
-Ref: Note on company-mode overlay pop-up-Footnote-1218941
-Ref: Note on company-mode overlay pop-up-Footnote-2219008
-Node: Note on ERC escaped color sequences219063
-Ref: Note on ERC escaped color sequences-Footnote-1220491
-Node: Note on powerline or spaceline220601
-Node: Note on SHR colors221015
-Node: Note on SHR fonts221439
-Node: Note on Ement colors and fonts222126
-Node: Note on pdf-tools link hints223636
-Node: Note on the Notmuch logo226096
-Node: Note on goto-address-mode faces226634
-Node: Frequently Asked Questions227752
-Node: Is the contrast ratio about adjacent colors?228385
-Node: What does it mean to avoid exaggerations?229894
-Node: Why are colors mostly variants of blue magenta cyan?231746
-Node: What is the best setup for legibility?236080
-Node: Are these color schemes?238728
-Node: Port the Modus themes to other platforms?242412
-Node: Contributing245258
-Node: Sources of the themes245657
-Node: Issues you can help with246553
-Node: Patches require copyright assignment to the FSF247946
-Node: Acknowledgements250168
-Node: GNU Free Documentation License254501
-Node: Indices279865
-Node: Function index280044
-Node: Variable index281640
-Node: Concept index285140
+Node: Overview8534
+Node: How do the themes look like11320
+Node: Learn about the latest changes11701
+Node: Installation12089
+Node: Install manually from source13019
+Node: Install from the archives13859
+Node: Install on GNU/Linux14473
+Node: Debian 11 Bullseye14966
+Node: GNU Guix15391
+Node: Dealing with byte compilation errors15689
+Node: Enable and load16871
+Node: The require-theme for built-in Emacs themes20931
+Node: Sample configuration with and without use-package22051
+Node: Differences between loading and enabling24955
+Node: Customization options27135
+Node: Custom reload theme31060
+Node: Disable other themes31996
+Node: Bold constructs33272
+Node: Italic constructs34144
+Node: Option for which themes to toggle34972
+Node: Option for which themes to rotate35735
+Node: Mixed fonts36511
+Node: Command prompts37565
+Node: Completion UIs39408
+Node: Org mode blocks42259
+Node: Heading styles42999
+Node: UI typeface47429
+Node: Palette overrides48402
+Node: Palette extension52834
+Node: Preview theme colors55310
+Node: Use colors from the Modus themes palette56866
+Node: Get a single color from the palette with
modus-themes-get-color-value57899
+Node: Use theme colors in code with modus-themes-with-colors60283
+Node: Advanced customization62637
+Node: DIY Palette override presets64404
+Node: DIY Add support for engrave-faces67246
+Node: DIY Stylistic variants using palette overrides77273
+Node: DIY Make the mode line borderless79273
+Node: DIY Make the active mode line colorful80648
+Node: DIY Make the tab bar more or less colorful82866
+Node: DIY Make the fringe invisible or another color84803
+Node: DIY Make links use subtle or no underlines86004
+Node: DIY Make prompts more or less colorful87122
+Node: DIY Make completion matches more or less colorful88445
+Node: DIY Make comments yellow and strings green92004
+Node: DIY Make code syntax use the old alt-syntax style93713
+Node: DIY Make use of alternative styles for code syntax96836
+Node: DIY Make matching parenthesis more or less intense100298
+Node: DIY Make box buttons more or less gray101670
+Node: DIY Make TODO and DONE more or less intense102683
+Node: DIY Make headings more or less colorful104184
+Node: DIY Make Org block colors more or less colorful106301
+Node: DIY Make Org agenda more or less colorful110760
+Node: DIY Make inline code in prose use alternative styles113935
+Node: DIY Make mail citations and headers more or less colorful116229
+Node: DIY Make the region preserve text colors, plus other styles118630
+Node: DIY Make mouse highlights more or less colorful120187
+Node: DIY Make language underlines less colorful121201
+Node: DIY Make line numbers use alternative styles122353
+Node: DIY Make diffs use only a foreground123996
+Node: DIY Make deuteranopia diffs red and blue instead of yellow and
blue126887
+Node: DIY More accurate colors in terminal emulators129367
+Node: DIY Range of color with terminal emulators130679
+Node: DIY Per-theme customization settings133493
+Node: DIY Do not extend the region background134926
+Node: DIY Add padding to the mode line135727
+Node: DIY Remap face with local value138661
+Node: DIY Font configurations for Org and others141208
+Ref: DIY Font configurations for Org and others-Footnote-1144193
+Node: DIY Configure bold and italic faces144380
+Node: DIY Custom Org todo keyword and priority faces149018
+Node: DIY Custom Org emphasis faces152761
+Node: DIY Use colored Org source blocks per language157642
+Node: DIY Measure color contrast162372
+Node: DIY Load theme depending on time of day165092
+Node: DIY Backdrop for pdf-tools166122
+Node: DIY Toggle themes without reloading them169325
+Node: DIY Use more spacious margins or padding in Emacs frames170674
+Node: DIY Custom hl-todo colors174931
+Node: DIY Add support for solaire-mode176748
+Node: DIY Add support for meow-mode179876
+Node: DIY Add support for combobulate181686
+Node: DIY Use a hook at the post-load-theme phase185309
+Node: DIY A theme-agnostic hook for theme loading187514
+Node: Face coverage190145
+Node: Supported packages190597
+Node: Indirectly covered packages196418
+Node: Notes on individual packages197774
+Node: Note on calendarel weekday and weekend colors198874
+Node: Note on git-gutter in Doom Emacs200022
+Node: Note on php-mode multiline comments202544
+Node: Note on underlines in compilation buffers203304
+Node: Note on inline Latex in Org buffers204176
+Node: Note on dimmerel204786
+Node: Note on display-fill-column-indicator-mode206271
+Node: Note on highlight-parenthesesel207724
+Node: Note on mmm-modeel background colors213827
+Node: Note for prism216181
+Node: Note on company-mode overlay pop-up219403
+Ref: Note on company-mode overlay pop-up-Footnote-1220133
+Ref: Note on company-mode overlay pop-up-Footnote-2220200
+Node: Note on ERC escaped color sequences220255
+Ref: Note on ERC escaped color sequences-Footnote-1221683
+Node: Note on powerline or spaceline221793
+Node: Note on SHR colors222207
+Node: Note on SHR fonts222631
+Node: Note on Ement colors and fonts223318
+Node: Note on pdf-tools link hints224846
+Node: Note on the Notmuch logo227306
+Node: Note on goto-address-mode faces227844
+Node: Frequently Asked Questions228962
+Node: Is the contrast ratio about adjacent colors?229542
+Node: What does it mean to avoid exaggerations?231051
+Node: Why are colors mostly variants of blue, magenta, cyan?232905
+Node: What is the best setup for legibility?237328
+Node: Are these color schemes?239978
+Node: Port the Modus themes to other platforms?243662
+Node: Contributing246564
+Node: Sources of the themes246963
+Node: Issues you can help with247859
+Node: Patches require copyright assignment to the FSF249299
+Node: Acknowledgements251521
+Node: GNU Free Documentation License255854
+Node: Indices281218
+Node: Function index281397
+Node: Variable index282993
+Node: Concept index286493
End Tag Table
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index 8b5940f83a..8aff347aca 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -1321,7 +1321,7 @@ semantic color mappings instead of the full palette
([[#h:34c7a691-19bb-4037-8d2
#+findex: modus-themes-preview-colors
#+findex: modus-themes-preview-colors-current
-Aliases for these commands are ~modus-themes-preview-colors~ and
+Aliases for those commands are ~modus-themes-preview-colors~ and
~modus-themes-preview-colors-current~.
Each row includes a foreground and background rendition of the given
@@ -1356,7 +1356,7 @@ value in some other application.
:END:
#+findex: modus-themes-get-color-value
-The fuction ~modus-themes-get-color-value~ can be called from Lisp to
+The function ~modus-themes-get-color-value~ can be called from Lisp to
return the value of a color from the active Modus theme palette. It
takea a =COLOR= argument and an optional =OVERRIDES=. It also accepts
a third =THEME= argument, to get the color from the given theme.
@@ -2936,7 +2936,7 @@ Reload the theme for changes to take effect.
:CUSTOM_ID: h:a5140c9c-18b2-45db-8021-38d0b5074116
:END:
-By the default, the background of the ~region~ face extends from the
+By default, the background of the ~region~ face extends from the
end of the line to the edge of the window. To limit it to the end of
the line, we need to override the face's =:extend= attribute. Adding
this to the Emacs configuration file will suffice:
@@ -5075,7 +5075,7 @@ Consult the doc string of ~shr-use-colors~.
:end:
#+cindex: Fonts in EWW, Elfeed, Ement, and SHR
-By default, packages that build on top of the Simple HTML Remember
+By default, packages that build on top of the Simple HTML Renderer
(~shr~) use proportionately spaced fonts. This is controlled by the
user option ~shr-use-fonts~, which is set to non-~nil~ by default. To
use the standard font instead, set that variable to ~nil~.
