Acknowledge Benjamin Kästner for commit 44cc370

This was done in pull request 212: <https://github.com/protesilaos/modus-themes/pull/212>.

The change is within the ~15-line limit for non-trivial changes,
meaning that Benjamin does not need to assign copyright to the Free
Software Foundation.

2 files changed, 333 insertions, 291 deletions

diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 8f0c9eb..d3cf6e4 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -176,7 +176,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::
@@ -232,7 +232,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?::
@@ -301,7 +301,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
@@ -325,7 +325,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
@@ -383,7 +384,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
@@ -399,7 +401,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
@@ -427,7 +429,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.
@@ -442,7 +445,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
@@ -471,7 +475,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
@@ -493,8 +497,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
@@ -564,13 +568,14 @@ 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’, ‘modus-themes-rotate’,
 ‘modus-themes-load-random’, 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.
 
    Convenience commands for loading only dark or light themes are:
 
@@ -618,7 +623,7 @@ File: modus-themes.info,  Node: Sample configuration,  Next: Differences between
 ========================
 
 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:
@@ -665,7 +670,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'
@@ -713,7 +719,7 @@ session, are better off using something like this:
    *note Toggle themes without reloading them: DIY Toggle themes without
 reloading them.
 
-   *note Sample configuration::.
+   *note Sample configuration: Sample configuration.
 
    With the above granted, other sections of the manual discuss how to
 configure custom faces, where ‘load-theme’ is expected, though
@@ -738,8 +744,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'.
@@ -819,9 +825,9 @@ Brief: Disable all other themes when loading a Modus theme.
 (and any related convenience wrappers like
 ‘modus-themes-load-random-dark’), 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.
+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.
@@ -929,8 +935,8 @@ Brief: Specify which themes to rotate through when using the command
    • Any of the themes listed in the value of the variable
      ‘modus-themes-items’.
    • Any of the themes returned by the function
-     ‘modus-themes-get-themes’ (*note Build on top of the Modus
-     themes::).
+     ‘modus-themes-get-themes’ (*note Build on top of the Modus themes:
+     Build on top of the Modus themes.).
 
    When the value is a list of themes, ‘modus-themes-rotate’ will go
 through them from left to right.  With an optional prefix argument
@@ -1099,11 +1105,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
@@ -1360,7 +1367,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:
@@ -1450,7 +1458,7 @@ File: modus-themes.info,  Node: Preview theme colors,  Next: Use colors from the
 The command ‘modus-themes-list-colors’ uses minibuffer completion to
 select an item from the Modus themes and then produces a buffer with
 previews of all of its color palette entries (*note Commands for the
-preview palette buffer::).
+preview palette buffer: Commands for the preview palette buffer.).
 
    The command ‘modus-themes-list-colors-current’ skips the minibuffer
 selection process to produce a preview for the current Modus theme.
@@ -1487,8 +1495,8 @@ File: modus-themes.info,  Node: Commands for the preview palette buffer,  Up: Pr
 
 The palette preview buffer uses the major mode
 ‘modus-themes-preview-mode’, which provides the
-‘modus-themes-preview-mode-map’ (*note Preview theme colors::).  The
-following key bindings are available by default:
+‘modus-themes-preview-mode-map’ (*note Preview theme colors: Preview
+theme colors.).  The following key bindings are available by default:
 
 Default key binding   Name of the command
 ---------------------------------------------------------------
@@ -1528,15 +1536,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:
 
@@ -1555,7 +1565,7 @@ 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
@@ -1620,8 +1630,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))
@@ -1630,12 +1640,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: Build on top of the Modus themes,  Prev: Use colors from the Modus themes palette,  Up: Top
@@ -1753,7 +1765,8 @@ File: modus-themes.info,  Node: DIY Add support for vc-annotate,  Next: DIY Add
 
 The built-in ‘vc-annotate’ command relies on a user option to read color
 values.  Users thus need to write their own configuration like this
-(*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.):
 
      (defun my-modus-vc-annotate (&rest _)
        (modus-themes-with-colors
@@ -1797,7 +1810,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
@@ -1912,7 +1925,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::
@@ -2621,7 +2634,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
@@ -2637,7 +2651,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
@@ -2725,7 +2740,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
@@ -2763,7 +2779,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.4.18 DIY Make mail citations and headers more or less colorful
 ----------------------------------------------------------------
@@ -2822,7 +2838,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.4.19 DIY Make the region preserve text colors, plus other styles
 ------------------------------------------------------------------
@@ -2856,7 +2872,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.4.20 DIY Make mouse highlights more or less colorful
 ------------------------------------------------------
@@ -3107,8 +3123,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)
@@ -3205,8 +3221,8 @@ Emacs configuration file will suffice:
      (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.
+   *note Make the region preserve text colors, plus other styles: DIY
+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
@@ -3465,10 +3481,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.
@@ -3715,7 +3732,8 @@ File: modus-themes.info,  Node: DIY Use colored Org source blocks per language,
 7.15 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
@@ -3757,7 +3775,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
@@ -3923,7 +3942,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
@@ -3986,7 +4005,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’.
 
@@ -4162,7 +4182,7 @@ Modus 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.
@@ -4278,10 +4298,12 @@ themes and is called at the end of one the following (or their
 derivatives):
 
 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-rotate’
-     *note Option for which themes to rotate::.
+     *note Option for which themes to rotate: Option for which themes to
+     rotate.
 
 Command ‘modus-themes-select’
      Select a Modus theme using minibuffer completion and then load it.
@@ -4297,9 +4319,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:
@@ -4390,7 +4413,8 @@ have to provide lots of compatibility aliases.  Whereas a new theme can
 be as simple as a single file that only calls ‘modus-themes-theme’.
 This manual covers everything in detail with examples that can be
 copy-pasted directly, both for private use or to create a new package
-(*note Complete example of a Modus derivative theme::).
+(*note Complete example of a Modus derivative theme: Complete example of
+a Modus derivative theme.).
 
    A theme exists in a file whose directory is in the
 ‘custom-theme-load-path’.  The theme file is named ‘NAME-theme.el’.  For
@@ -4511,15 +4535,18 @@ File: modus-themes.info,  Node: Complete example of a Modus derivative theme,  N
 8.1 Complete example of a Modus derivative theme
 ================================================
 
-[ For more context: *note Build on top of the Modus themes::.  ]
+[ For more context: *note Build on top of the Modus themes: Build on top
+of the Modus themes.  ]
 
    In this section, we show how to define a new Modus derivative theme.
 In its simplest form, a theme is a file called ‘NAME-theme.el’ in a
 directory that is part of the ‘custom-theme-load-path’.  We show how to
 do this for a package and for a private configuration:
 
-   • *note Complete example of a package that is derived from Modus::
-   • *note Complete example of a private theme derived from Modus::
+   • *note Complete example of a package that is derived from Modus:
+     Complete example of a package that is derived from Modus.
+   • *note Complete example of a private theme derived from Modus:
+     Complete example of a private theme derived from Modus.
 
 * Menu:
 
@@ -4536,7 +4563,7 @@ File: modus-themes.info,  Node: Complete example of a package that is derived fr
 
 For package developers, the following snippet needs to be included in
 each theme file (*note Complete example of a private theme derived from
-Modus::):
+Modus: Complete example of a private theme derived from Modus.):
 
      ;;;; Add themes from this package to the `custom-theme-load-path'
 
@@ -4568,7 +4595,8 @@ and therein we find at least the following:
      ;;; prot-themes.el ends here
 
    Then each individual theme can look like this (*note Complete example
-of a custom theme with its own palette::):
+of a custom theme with its own palette: Complete example of a custom
+theme with its own palette.):
 
      (require 'prot-themes)
 
@@ -4617,7 +4645,8 @@ Packages such as the ‘ef-themes’ and ‘standard-themes’ are exceptions
 because they existed for years before they were based on Modus and must
 remain backward compatible.
 
-   *note Arrange to activate your derivative themes::.
+   *note Arrange to activate your derivative themes: Arrange to activate
+your derivative themes.
 
 
 File: modus-themes.info,  Node: Complete example of a private theme derived from Modus,  Next: Complete example of a custom theme with its own palette,  Prev: Complete example of a package that is derived from Modus,  Up: Complete example of a Modus derivative theme
@@ -4626,8 +4655,9 @@ File: modus-themes.info,  Node: Complete example of a private theme derived from
 ------------------------------------------------------------
 
 If your derivative theme is not going to be distributed as a package
-(*note Complete example of a package that is derived from Modus::), then
-create a directory where all custom themes are stored and add it to the
+(*note Complete example of a package that is derived from Modus:
+Complete example of a package that is derived from Modus.), then create
+a directory where all custom themes are stored and add it to the
 ‘custom-theme-load-path’.  For example, the ‘my-custom-themes’ directory
 can be included thus somewhere in the Emacs initialization file:
 
@@ -4643,7 +4673,8 @@ your theme is named ‘prot-light’ the file is called
 ‘prot-light-theme.el’.
 
    At minimum, the contents of a theme file are these (*note Complete
-example of a custom theme with its own palette::):
+example of a custom theme with its own palette: Complete example of a
+custom theme with its own palette.):
 
      (modus-themes-theme
       'prot-light
@@ -4654,7 +4685,8 @@ example of a custom theme with its own palette::):
       nil
       nil)
 
-   *note Arrange to activate your derivative themes::.
+   *note Arrange to activate your derivative themes: Arrange to activate
+your derivative themes.
 
 
 File: modus-themes.info,  Node: Complete example of a custom theme with its own palette,  Next: Complete example that also uses modus-themes-generate-palette,  Prev: Complete example of a private theme derived from Modus,  Up: Complete example of a Modus derivative theme
@@ -4669,11 +4701,12 @@ definitions are inherited by the derivative theme.
 
    The derivative may then add its own colors to the user palette, which
 will override the core palette in such of a conflict (*note Preview
-theme colors::).
+theme colors: Preview theme colors.).
 
    The core and user palettes are among the arguments passed to the
 ‘modus-themes-theme’ functions, as explained elsewhere in this manual
-(*note Build on top of the Modus themes::).
+(*note Build on top of the Modus themes: Build on top of the Modus
+themes.).
 
    In the following example, we are defining the ‘prot-light’ theme in
 the ‘prot-light-theme.el’ file.  This theme declares itself as belonging
@@ -4770,7 +4803,8 @@ this example, ‘bg-ochre’ comes from the ‘modus-operandi-palette’ though
 it would work the same way if, say, ‘prot-light-palette’ defined
 ‘bg-soil’ and then referenced it in ‘prot-light-custom-faces’.
 
-   *note Arrange to activate your derivative themes::.
+   *note Arrange to activate your derivative themes: Arrange to activate
+your derivative themes.
 
 
 File: modus-themes.info,  Node: Complete example that also uses modus-themes-generate-palette,  Prev: Complete example of a custom theme with its own palette,  Up: Complete example of a Modus derivative theme
@@ -4780,7 +4814,7 @@ File: modus-themes.info,  Node: Complete example that also uses modus-themes-gen
 
 The guide herein is of use to those who plan to create their own
 derivative themes (*note Complete example of a private theme derived
-from Modus::).
+from Modus: Complete example of a private theme derived from Modus.).
 
    The ‘modus-themes-generate-palette’ defines a fully flegded Modus
 palette that can be passed to ‘modus-themes-theme’ without necessarily
@@ -4926,9 +4960,10 @@ was originally designed for terminal emulators and quickly turning it
 into a fully fledged Modus palette.  All they need is to follow the
 naming convention for ‘bg-main’, ‘fg-main’, and then
 ‘{red,green,yellow,blue,magenta,cyan}{,-warmer,-cooler}’.  Preview a
-palette to get the complete list (*note Preview theme colors::).  And,
-again, remember that not all colors need to be defined in ‘BASE-COLORS’
-(e.g.  we could leave out ‘magenta-cooler’ if we do not care about it).
+palette to get the complete list (*note Preview theme colors: Preview
+theme colors.).  And, again, remember that not all colors need to be
+defined in ‘BASE-COLORS’ (e.g.  we could leave out ‘magenta-cooler’ if
+we do not care about it).
 
    The next optional parameter of ‘modus-themes-generate-palette’ is the
 ‘CORE-PALETTE’ it should use.  This is to make explicit the decision
@@ -4976,10 +5011,10 @@ Palette overrides.).  The ‘NAME’ has the same meaning as for the
 ‘BASE-COLORS’ we have been examining all along, while ‘OTHER-NAME’ is
 the symbol of another ‘NAME’ that exists in the palette, hence the
 mapping.  This manual contains lots of examples along those lines (*note
-DIY Stylistic variants using palette overrides::).  For our purposes, we
-will modify some of the obvious elements of the theme, namely, the
-cursor, mode lines, current line highlight, matching parentheses, and
-active region.
+DIY Stylistic variants using palette overrides: DIY Stylistic variants
+using palette overrides.).  For our purposes, we will modify some of the
+obvious elements of the theme, namely, the cursor, mode lines, current
+line highlight, matching parentheses, and active region.
 
      (modus-themes-generate-palette
         '((bg-main "#073642")
@@ -5020,7 +5055,8 @@ refine it one small step at a time.
 
    We are now ready to try our Solarized themes, using the example of
 doing this in our private configuration (*note Complete example of a
-package that is derived from Modus::).
+package that is derived from Modus: Complete example of a package that
+is derived from Modus.).
 
    • Create two files, one is called ‘modus-solarized-dark-theme.el’ (or
      however you want to identify it, but always keep ‘-theme.el’ at the
@@ -5142,7 +5178,8 @@ package that is derived from Modus::).
       nil
       nil)
 
-   *note Arrange to activate your derivative themes::.
+   *note Arrange to activate your derivative themes: Arrange to activate
+your derivative themes.
 
 
 File: modus-themes.info,  Node: Determine what counts as a Modus theme,  Next: Create convenience commands to load a derivative theme,  Prev: Complete example of a Modus derivative theme,  Up: Build on top of the Modus themes
@@ -5158,7 +5195,7 @@ what is described herein.  Just enable the
 of the function ‘modus-themes-get-all-known-themes’.  This function
 accepts an optional argument to filter themes by their given family, as
 specified at the time of the theme's reification (*note Build on top of
-the Modus themes::).
+the Modus themes: Build on top of the Modus themes.).
 
    The generic function ‘modus-themes-get-themes’ is how
 developers/users can affect what counts as a "Modus" theme.  By default,
@@ -5225,11 +5262,12 @@ what is described herein.  Just enable the
 ‘modus-themes-include-derivatives-mode’.  ]
 
    In the previous section, we explored the mechanics of the
-‘modus-themes-get-themes’ (*note Determine what counts as a Modus
-theme::).  Independent of that method, developers can use the macro
-‘modus-themes-define-derivative-command’ to define small wrappers for
-Modus commands that load a theme only for a specific family of Modus
-derivatives (*note Build on top of the Modus themes::).
+‘modus-themes-get-themes’ (*note Determine what counts as a Modus theme:
+Determine what counts as a Modus theme.).  Independent of that method,
+developers can use the macro ‘modus-themes-define-derivative-command’ to
+define small wrappers for Modus commands that load a theme only for a
+specific family of Modus derivatives (*note Build on top of the Modus
+themes: Build on top of the Modus themes.).
 
    The ‘modus-themes-define-derivative-command’ takes two mandatory
 arguments:
@@ -5273,10 +5311,11 @@ File: modus-themes.info,  Node: Arrange to activate your derivative themes,  Pre
 
 The ‘modus-themes-theme’ function is responsible for instantiating a
 theme and registering it for use by the various Modus commands that act
-on a theme (*note Build on top of the Modus themes::).  Due to how Emacs
-themes are designed to be bound to files, ‘modus-themes-theme’ can only
-work if the given theme file is already loaded.  Otherwise our function
-is never called and the theme is never created.
+on a theme (*note Build on top of the Modus themes: Build on top of the
+Modus themes.).  Due to how Emacs themes are designed to be bound to
+files, ‘modus-themes-theme’ can only work if the given theme file is
+already loaded.  Otherwise our function is never called and the theme is
+never created.
 
    To this end, users need to call the function ‘modus-themes-activate’
 with each theme they want as an argument.  Remember that themes are
@@ -5749,7 +5788,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.
@@ -5928,7 +5967,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
@@ -6304,7 +6343,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:
 
@@ -6420,7 +6459,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?::
@@ -6454,7 +6493,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
 
 11.2 What does it mean to avoid exaggerations?
 ==============================================
@@ -6487,7 +6526,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
 
 11.3 Why are colors mostly variants of blue, magenta, cyan?
 ===========================================================
@@ -6497,7 +6536,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
@@ -6540,7 +6580,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
@@ -6575,7 +6616,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
 
 11.4 What is the best setup for legibility?
 ===========================================
@@ -6720,7 +6761,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
@@ -6732,12 +6773,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
@@ -6810,7 +6851,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
@@ -6897,20 +6939,20 @@ Author/maintainer
 
 Contributions to code or documentation
      Aleksei Gusev, Alex Griffin, Anders Johansson, Antonio Ruiz, Basil
-     L. Contovounesios, Björn Lindström, Carlo Zancanaro, Christian
-     Tietze, Daniel Colascione, Daniel Mendler, David Edmondson, Eli
-     Zaretskii, Eric Ottosson, Frédéric Giquel, Fritz Grabo, Gautier
-     Ponsinet, Illia Ostapyshyn, Jacob S. Gordon, Jared Finder, JD
-     Smith, Jimmy Yuen Ho Wong, Kevin Fleming, Kévin Le Gouguec, Koen
-     van Greevenbroek, Kostadin Ninev, Leilei332, Madhavan Krishnan,
-     Manuel Giraud, Markus Beppler, Matthew Stevenson, Mauro Aranda,
-     Mike Olson, Nacho Barrientos, Niall Dooley, Nicolas De Jaeghere,
-     Paul David, Pavel Novichkov, Philip Kaludercic, Pierre Téchoueyres,
-     Rahul M. Juliato, Rudolf Adamkovič, Sergey Nichiporchik, Shreyas
-     Ragavan, Stefan x Kangas, Stephen Berman, Stephen Gildea, Steve
-     Downey, Steven Allen, Suleyman Boyar, Thanos Apollo, Tomasz
-     Hołubowicz, Utkarsh Singh, Vincent Murphy, Xinglu Chen, Yuanchen
-     Xie, fluentpwn, okamsn, ukiran03.
+     L. Contovounesios, Benjamin Kästner, Björn Lindström, Carlo
+     Zancanaro, Christian Tietze, Daniel Colascione, Daniel Mendler,
+     David Edmondson, Eli Zaretskii, Eric Ottosson, Frédéric Giquel,
+     Fritz Grabo, Gautier Ponsinet, Illia Ostapyshyn, Jacob S. Gordon,
+     Jared Finder, JD Smith, Jimmy Yuen Ho Wong, Kevin Fleming, Kévin Le
+     Gouguec, Koen van Greevenbroek, Kostadin Ninev, Leilei332, Madhavan
+     Krishnan, Manuel Giraud, Markus Beppler, Matthew Stevenson, Mauro
+     Aranda, Mike Olson, Nacho Barrientos, Niall Dooley, Nicolas De
+     Jaeghere, Paul David, Pavel Novichkov, Philip Kaludercic, Pierre
+     Téchoueyres, Rahul M. Juliato, Rudolf Adamkovič, Sergey
+     Nichiporchik, Shreyas Ragavan, Stefan x Kangas, Stephen Berman,
+     Stephen Gildea, Steve Downey, Steven Allen, Suleyman Boyar, Thanos
+     Apollo, Tomasz Hołubowicz, Utkarsh Singh, Vincent Murphy, Xinglu
+     Chen, Yuanchen Xie, fluentpwn, okamsn, ukiran03.
 
 Ideas and user feedback
      Aaron Jensen, Adam Porter, Adam Spiers, Adrian Manea, Aleksei
@@ -7496,8 +7538,8 @@ B.1 Function index
 * modus-themes-load-random:              Enable and load.     (line  94)
 * modus-themes-load-random <1>:          Disable other themes.
                                                               (line  15)
-* modus-themes-load-random-dark:         Enable and load.     (line 105)
-* modus-themes-load-random-light:        Enable and load.     (line 107)
+* modus-themes-load-random-dark:         Enable and load.     (line 106)
+* modus-themes-load-random-light:        Enable and load.     (line 108)
 * modus-themes-load-theme:               Enable and load.     (line  80)
 * modus-themes-load-theme <1>:           Disable other themes.
                                                               (line  15)
@@ -7527,10 +7569,10 @@ B.1 Function index
 * modus-themes-select:                   Enable and load.     (line  94)
 * modus-themes-select <1>:               Disable other themes.
                                                               (line  15)
-* modus-themes-select-dark:              Enable and load.     (line 101)
-* modus-themes-select-light:             Enable and load.     (line 103)
+* modus-themes-select-dark:              Enable and load.     (line 102)
+* modus-themes-select-light:             Enable and load.     (line 104)
 * modus-themes-theme:                    Build on top of the Modus themes.
-                                                              (line  20)
+                                                              (line  21)
 * modus-themes-toggle:                   Enable and load.     (line  94)
 * modus-themes-toggle <1>:               Disable other themes.
                                                               (line  15)
@@ -7551,7 +7593,7 @@ B.2 Variable index
 * Menu:
 
 * ~modus-themes-define-derivative-command-known-suffixes~: Create convenience commands to load a derivative theme.
-                                                               (line 23)
+                                                               (line 24)
 * modus-operandi-deuteranopia-palette-overrides: Palette overrides.
                                                                (line 30)
 * modus-operandi-deuteranopia-palette-user: Palette extension. (line 24)
@@ -7568,10 +7610,10 @@ B.2 Variable index
 * modus-themes-common-palette-user:      Palette extension.    (line 16)
 * modus-themes-completions:              Completion UIs.       (line  6)
 * modus-themes-custom-variables:         Build on top of the Modus themes.
-                                                               (line 68)
+                                                               (line 69)
 * modus-themes-disable-other-themes:     Disable other themes. (line  6)
 * modus-themes-faces:                    Build on top of the Modus themes.
-                                                               (line 62)
+                                                               (line 63)
 * modus-themes-headings:                 Heading styles.       (line  6)
 * modus-themes-italic-constructs:        Italic constructs.    (line  6)
 * modus-themes-items:                    Option for which themes to rotate.
@@ -7593,7 +7635,7 @@ B.2 Variable index
                                                                (line  6)
 * modus-themes-prompts:                  Command prompts.      (line  6)
 * modus-themes-registered-items:         Build on top of the Modus themes.
-                                                               (line 20)
+                                                               (line 21)
 * modus-themes-to-rotate:                Option for which themes to rotate.
                                                                (line  9)
 * modus-themes-to-toggle:                Option for which themes to toggle.
@@ -7649,7 +7691,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)
@@ -7683,143 +7725,143 @@ B.3 Concept index
 
 Tag Table:
 Node: Top874
-Node: Overview9188
-Node: How do the themes look like11954
-Node: Learn about the latest changes12313
-Node: Installation12701
-Node: Install manually from source13612
-Node: Install from the archives14435
-Node: Install on GNU/Linux15034
-Node: Debian 11 Bullseye15525
-Node: GNU Guix15933
-Node: Dealing with byte compilation errors16216
-Node: Enable and load17374
-Node: The require-theme for built-in Emacs themes21605
-Node: Sample configuration22522
-Node: Differences between loading and enabling24798
-Node: Customization options26863
-Node: Disable other themes30632
-Node: Bold constructs31986
-Node: Italic constructs32858
-Node: Option for which themes to toggle33686
-Node: Option for which themes to rotate34449
-Node: Mixed fonts35446
-Node: Command prompts36500
-Node: Completion UIs38341
-Node: Org mode blocks41190
-Node: Heading styles41833
-Node: UI typeface46259
-Node: Palette overrides47232
-Node: Palette extension51589
-Node: Preview theme colors54065
-Node: Commands for the preview palette buffer55720
-Node: Use colors from the Modus themes palette57798
-Node: Get a single color from the palette with modus-themes-get-color-value58662
-Node: Use theme colors in code with modus-themes-with-colors61023
-Node: Advanced customization63277
-Node: DIY Palette override presets65091
-Node: DIY Add support for vc-annotate67923
-Node: DIY Add support for engrave-faces69405
-Node: DIY Stylistic variants using palette overrides79391
-Node: DIY Make the mode line borderless81450
-Node: DIY Make the active mode line colorful82825
-Node: DIY Make the tab bar more or less colorful85043
-Node: DIY Make the fringe invisible or another color86980
-Node: DIY Make links use subtle or no underlines88177
-Node: DIY Make prompts more or less colorful89295
-Node: DIY Make completion matches more or less colorful90618
-Node: DIY Make comments yellow and strings green94177
-Node: DIY Make code syntax use the old alt-syntax style95884
-Node: DIY Make use of alternative styles for code syntax98997
-Node: DIY Make matching parenthesis more or less intense102459
-Node: DIY Make box buttons more or less gray103831
-Node: DIY Make TODO and DONE more or less intense104844
-Node: DIY Make headings more or less colorful106345
-Node: DIY Make Org block colors more or less colorful108462
-Node: DIY Make Org agenda more or less colorful112834
-Node: DIY Make inline code in prose use alternative styles116009
-Node: DIY Make mail citations and headers more or less colorful118249
-Node: DIY Make the region preserve text colors plus other styles120649
-Node: DIY Make mouse highlights more or less colorful122205
-Node: DIY Make language underlines less colorful123218
-Node: DIY Make line numbers use alternative styles124370
-Node: DIY Make diffs use only a foreground126013
-Node: DIY Make deuteranopia diffs red and blue instead of yellow and blue128900
-Node: DIY More accurate colors in terminal emulators131372
-Node: DIY Range of color with terminal emulators132680
-Node: DIY Per-theme customization settings135467
-Node: DIY Do not extend the region background136900
-Node: DIY Add padding to the mode line137698
-Node: DIY Remap face with local value140626
-Node: DIY Font configurations for Org and others143167
-Ref: DIY Font configurations for Org and others-Footnote-1146150
-Node: DIY Configure bold and italic faces146337
-Node: DIY Custom Org todo keyword and priority faces150959
-Node: DIY Custom Org emphasis faces154700
-Node: DIY Use colored Org source blocks per language159577
-Node: DIY Measure color contrast164217
-Node: DIY Load theme depending on time of day166934
-Node: DIY Backdrop for pdf-tools167962
-Node: DIY Toggle themes without reloading them171123
-Node: DIY Use more spacious margins or padding in Emacs frames172432
-Node: DIY Custom hl-todo colors176669
-Node: DIY Add support for solaire-mode178486
-Node: DIY Add support for meow-mode181578
-Node: DIY Add support for combobulate183388
-Node: DIY Use a hook at the post-load-theme phase187011
-Node: DIY A theme-agnostic hook for theme loading189238
-Node: Build on top of the Modus themes191869
-Node: Complete example of a Modus derivative theme198089
-Node: Complete example of a package that is derived from Modus199095
-Node: Complete example of a private theme derived from Modus202090
-Node: Complete example of a custom theme with its own palette203712
-Node: Complete example that also uses modus-themes-generate-palette208379
-Node: Determine what counts as a Modus theme225148
-Node: Create convenience commands to load a derivative theme228558
-Node: Arrange to activate your derivative themes230826
-Node: Face coverage232882
-Node: Supported packages233344
-Node: Indirectly covered packages239343
-Node: Notes on individual packages240699
-Node: Note on calendarel weekday and weekend colors241801
-Node: Note on git-gutter in Doom Emacs242951
-Node: Note on php-mode multiline comments245453
-Node: Note on underlines in compilation buffers246215
-Node: Note on inline Latex in Org buffers247089
-Node: Note on dimmerel247701
-Node: Note on display-fill-column-indicator-mode249188
-Node: Note on highlight-parenthesesel250641
-Node: Note on mmm-modeel background colors256720
-Node: Note for prism259074
-Node: Note on company-mode overlay pop-up262288
-Ref: Note on company-mode overlay pop-up-Footnote-1263018
-Ref: Note on company-mode overlay pop-up-Footnote-2263085
-Node: Note on ERC escaped color sequences263140
-Ref: Note on ERC escaped color sequences-Footnote-1264570
-Node: Note on powerline or spaceline264680
-Node: Note on SHR colors265096
-Node: Note on SHR fonts265518
-Node: Note on Ement colors and fonts266207
-Node: Note on pdf-tools link hints267713
-Node: Note on the Notmuch logo270171
-Node: Note on goto-address-mode faces270705
-Node: Frequently Asked Questions271825
-Node: Is the contrast ratio about adjacent colors?272456
-Node: What does it mean to avoid exaggerations?273965
-Node: Why are colors mostly variants of blue magenta cyan?275815
-Node: What is the best setup for legibility?280149
-Node: Are these color schemes?282791
-Node: Port the Modus themes to other platforms?286445
-Node: Contributing289279
-Node: Sources of the themes289678
-Node: Issues you can help with290574
-Node: Patches require copyright assignment to the FSF291966
-Node: Acknowledgements294188
-Node: GNU Free Documentation License298967
-Node: Indices324130
-Node: Function index324309
-Node: Variable index329467
-Node: Concept index334184
+Node: Overview9076
+Node: How do the themes look like11856
+Node: Learn about the latest changes12237
+Node: Installation12625
+Node: Install manually from source13536
+Node: Install from the archives14374
+Node: Install on GNU/Linux14988
+Node: Debian 11 Bullseye15479
+Node: GNU Guix15902
+Node: Dealing with byte compilation errors16200
+Node: Enable and load17382
+Node: The require-theme for built-in Emacs themes21680
+Node: Sample configuration22597
+Node: Differences between loading and enabling24929
+Node: Customization options27014
+Node: Disable other themes30799
+Node: Bold constructs32187
+Node: Italic constructs33059
+Node: Option for which themes to toggle33887
+Node: Option for which themes to rotate34650
+Node: Mixed fonts35680
+Node: Command prompts36734
+Node: Completion UIs38575
+Node: Org mode blocks41424
+Node: Heading styles42162
+Node: UI typeface46588
+Node: Palette overrides47561
+Node: Palette extension51939
+Node: Preview theme colors54415
+Node: Commands for the preview palette buffer56110
+Node: Use colors from the Modus themes palette58209
+Node: Get a single color from the palette with modus-themes-get-color-value59242
+Node: Use theme colors in code with modus-themes-with-colors61624
+Node: Advanced customization63976
+Node: DIY Palette override presets65790
+Node: DIY Add support for vc-annotate68622
+Node: DIY Add support for engrave-faces70148
+Node: DIY Stylistic variants using palette overrides80178
+Node: DIY Make the mode line borderless82178
+Node: DIY Make the active mode line colorful83553
+Node: DIY Make the tab bar more or less colorful85771
+Node: DIY Make the fringe invisible or another color87708
+Node: DIY Make links use subtle or no underlines88905
+Node: DIY Make prompts more or less colorful90023
+Node: DIY Make completion matches more or less colorful91346
+Node: DIY Make comments yellow and strings green94905
+Node: DIY Make code syntax use the old alt-syntax style96612
+Node: DIY Make use of alternative styles for code syntax99725
+Node: DIY Make matching parenthesis more or less intense103187
+Node: DIY Make box buttons more or less gray104559
+Node: DIY Make TODO and DONE more or less intense105572
+Node: DIY Make headings more or less colorful107073
+Node: DIY Make Org block colors more or less colorful109190
+Node: DIY Make Org agenda more or less colorful113647
+Node: DIY Make inline code in prose use alternative styles116822
+Node: DIY Make mail citations and headers more or less colorful119114
+Node: DIY Make the region preserve text colors, plus other styles121517
+Node: DIY Make mouse highlights more or less colorful123076
+Node: DIY Make language underlines less colorful124092
+Node: DIY Make line numbers use alternative styles125244
+Node: DIY Make diffs use only a foreground126887
+Node: DIY Make deuteranopia diffs red and blue instead of yellow and blue129774
+Node: DIY More accurate colors in terminal emulators132246
+Node: DIY Range of color with terminal emulators133554
+Node: DIY Per-theme customization settings136362
+Node: DIY Do not extend the region background137795
+Node: DIY Add padding to the mode line138596
+Node: DIY Remap face with local value141524
+Node: DIY Font configurations for Org and others144065
+Ref: DIY Font configurations for Org and others-Footnote-1147048
+Node: DIY Configure bold and italic faces147235
+Node: DIY Custom Org todo keyword and priority faces151873
+Node: DIY Custom Org emphasis faces155614
+Node: DIY Use colored Org source blocks per language160491
+Node: DIY Measure color contrast165221
+Node: DIY Load theme depending on time of day167938
+Node: DIY Backdrop for pdf-tools168966
+Node: DIY Toggle themes without reloading them172161
+Node: DIY Use more spacious margins or padding in Emacs frames173510
+Node: DIY Custom hl-todo colors177747
+Node: DIY Add support for solaire-mode179564
+Node: DIY Add support for meow-mode182678
+Node: DIY Add support for combobulate184488
+Node: DIY Use a hook at the post-load-theme phase188111
+Node: DIY A theme-agnostic hook for theme loading190458
+Node: Build on top of the Modus themes193089
+Node: Complete example of a Modus derivative theme199354
+Node: Complete example of a package that is derived from Modus200514
+Node: Complete example of a private theme derived from Modus203662
+Node: Complete example of a custom theme with its own palette205439
+Node: Complete example that also uses modus-themes-generate-palette210202
+Node: Determine what counts as a Modus theme227193
+Node: Create convenience commands to load a derivative theme230636
+Node: Arrange to activate your derivative themes232976
+Node: Face coverage235065
+Node: Supported packages235527
+Node: Indirectly covered packages241526
+Node: Notes on individual packages242882
+Node: Note on calendarel weekday and weekend colors243984
+Node: Note on git-gutter in Doom Emacs245134
+Node: Note on php-mode multiline comments247658
+Node: Note on underlines in compilation buffers248420
+Node: Note on inline Latex in Org buffers249294
+Node: Note on dimmerel249906
+Node: Note on display-fill-column-indicator-mode251393
+Node: Note on highlight-parenthesesel252846
+Node: Note on mmm-modeel background colors258947
+Node: Note for prism261301
+Node: Note on company-mode overlay pop-up264515
+Ref: Note on company-mode overlay pop-up-Footnote-1265245
+Ref: Note on company-mode overlay pop-up-Footnote-2265312
+Node: Note on ERC escaped color sequences265367
+Ref: Note on ERC escaped color sequences-Footnote-1266797
+Node: Note on powerline or spaceline266907
+Node: Note on SHR colors267323
+Node: Note on SHR fonts267745
+Node: Note on Ement colors and fonts268434
+Node: Note on pdf-tools link hints269958
+Node: Note on the Notmuch logo272416
+Node: Note on goto-address-mode faces272950
+Node: Frequently Asked Questions274070
+Node: Is the contrast ratio about adjacent colors?274648
+Node: What does it mean to avoid exaggerations?276157
+Node: Why are colors mostly variants of blue, magenta, cyan?278011
+Node: What is the best setup for legibility?282436
+Node: Are these color schemes?285082
+Node: Port the Modus themes to other platforms?288736
+Node: Contributing291626
+Node: Sources of the themes292025
+Node: Issues you can help with292921
+Node: Patches require copyright assignment to the FSF294360
+Node: Acknowledgements296582
+Node: GNU Free Documentation License301380
+Node: Indices326543
+Node: Function index326722
+Node: Variable index331880
+Node: Concept index336597
 
 End Tag Table
 
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index 02fd8ca..cd32c04 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -6725,20 +6725,20 @@ The Modus themes are a collective effort.  Every bit of work matters.
 
 + Contributions to code or documentation :: Aleksei Gusev, Alex
   Griffin, Anders Johansson, Antonio Ruiz, Basil L.{{{space()}}}
-  Contovounesios, Björn Lindström, Carlo Zancanaro, Christian Tietze,
-  Daniel Colascione, Daniel Mendler, David Edmondson, Eli Zaretskii,
-  Eric Ottosson, Frédéric Giquel, Fritz Grabo, Gautier Ponsinet, Illia
-  Ostapyshyn, Jacob S.{{{space()}}} Gordon, Jared Finder, JD Smith,
-  Jimmy Yuen Ho Wong, Kevin Fleming, Kévin Le Gouguec, Koen van
-  Greevenbroek, Kostadin Ninev, Leilei332, Madhavan Krishnan, Manuel
-  Giraud, Markus Beppler, Matthew Stevenson, Mauro Aranda, Mike Olson,
-  Nacho Barrientos, Niall Dooley, Nicolas De Jaeghere, Paul David,
-  Pavel Novichkov, Philip Kaludercic, Pierre Téchoueyres, Rahul
-  M.{{{space()}}} Juliato, Rudolf Adamkovič, Sergey Nichiporchik,
-  Shreyas Ragavan, Stefan x Kangas, Stephen Berman, Stephen Gildea,
-  Steve Downey, Steven Allen, Suleyman Boyar, Thanos Apollo, Tomasz
-  Hołubowicz, Utkarsh Singh, Vincent Murphy, Xinglu Chen, Yuanchen
-  Xie, fluentpwn, okamsn, ukiran03.
+  Contovounesios, Benjamin Kästner, Björn Lindström, Carlo Zancanaro,
+  Christian Tietze, Daniel Colascione, Daniel Mendler, David
+  Edmondson, Eli Zaretskii, Eric Ottosson, Frédéric Giquel, Fritz
+  Grabo, Gautier Ponsinet, Illia Ostapyshyn, Jacob S.{{{space()}}}
+  Gordon, Jared Finder, JD Smith, Jimmy Yuen Ho Wong, Kevin Fleming,
+  Kévin Le Gouguec, Koen van Greevenbroek, Kostadin Ninev, Leilei332,
+  Madhavan Krishnan, Manuel Giraud, Markus Beppler, Matthew Stevenson,
+  Mauro Aranda, Mike Olson, Nacho Barrientos, Niall Dooley, Nicolas De
+  Jaeghere, Paul David, Pavel Novichkov, Philip Kaludercic, Pierre
+  Téchoueyres, Rahul M.{{{space()}}} Juliato, Rudolf Adamkovič, Sergey
+  Nichiporchik, Shreyas Ragavan, Stefan x Kangas, Stephen Berman,
+  Stephen Gildea, Steve Downey, Steven Allen, Suleyman Boyar, Thanos
+  Apollo, Tomasz Hołubowicz, Utkarsh Singh, Vincent Murphy, Xinglu
+  Chen, Yuanchen Xie, fluentpwn, okamsn, ukiran03.
 
 + Ideas and user feedback :: Aaron Jensen, Adam Porter, Adam Spiers,
   Adrian Manea, Aleksei Pirogov, Alex Griffin, Alex Koen, Alex