Make modus-themes-custom-auto-reload obsolete

This commit is contained in:
Protesilaos Stavrou 2025-10-07 07:13:59 +03:00
parent 933a926247
commit cfa3545171
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
3 changed files with 149 additions and 224 deletions

View file

@ -105,7 +105,6 @@ Enable and load
Customization options
* Custom reload theme:: Toggle auto-reload of the theme when setting custom variables
* Disable other themes:: Determine whether loading a Modus themes disables all others
* Bold constructs:: Toggle bold constructs in code
* Italic constructs:: Toggle italic font constructs in code
@ -719,7 +718,6 @@ active, it must be reloaded for changes to take effect.
modus-themes-bold-constructs nil
modus-themes-mixed-fonts t
modus-themes-variable-pitch-ui nil
modus-themes-custom-auto-reload t
modus-themes-disable-other-themes t
;; Options for `modus-themes-prompts' are either nil (the
@ -757,7 +755,6 @@ active, it must be reloaded for changes to take effect.
* Menu:
* Custom reload theme:: Toggle auto-reload of the theme when setting custom variables
* Disable other themes:: Determine whether loading a Modus themes disables all others
* Bold constructs:: Toggle bold constructs in code
* Italic constructs:: Toggle italic font constructs in code
@ -773,36 +770,9 @@ active, it must be reloaded for changes to take effect.
* Palette extension:: Define new colors and use them like the original ones

File: modus-themes.info, Node: Custom reload theme, Next: Disable other themes, Up: Customization options
File: modus-themes.info, Node: Disable other themes, Next: Bold constructs, Up: Customization options
4.1 Option for reloading the theme on custom change
===================================================
Brief: Toggle reloading of the active theme when an option is changed
through the Custom UI.
Symbol: modus-themes-custom-auto-reload (boolean type)
Possible values:
1. nil
2. t (default)
All theme user options take effect when a theme is loaded. Any
subsequent changes require the theme to be reloaded.
When this variable has a non-nil value, any change made via the
Custom UI or related functions such as customize-set-variable and
setopt (Emacs 29), will trigger a reload automatically.
With a nil value, changes to user options have no further
consequences: the user must manually reload the theme (*note Enable and
load::).

File: modus-themes.info, Node: Disable other themes, Next: Bold constructs, Prev: Custom reload theme, Up: Customization options
4.2 Option for disabling other themes while loading Modus
4.1 Option for disabling other themes while loading Modus
=========================================================
Brief: Disable all other themes when loading a Modus theme.
@ -833,7 +803,7 @@ variable to a nil value.

File: modus-themes.info, Node: Bold constructs, Next: Italic constructs, Prev: Disable other themes, Up: Customization options
4.3 Option for more bold constructs
4.2 Option for more bold constructs
===================================
Brief: Use bold for code syntax highlighting and related.
@ -862,7 +832,7 @@ faces.

File: modus-themes.info, Node: Italic constructs, Next: Option for which themes to toggle, Prev: Bold constructs, Up: Customization options
4.4 Option for more italic constructs
4.3 Option for more italic constructs
=====================================
Brief: Use italics for code syntax highlighting and related.
@ -889,7 +859,7 @@ faces.

File: modus-themes.info, Node: Option for which themes to toggle, Next: Option for which themes to rotate, Prev: Italic constructs, Up: Customization options
4.5 Option for which themes to toggle
4.4 Option for which themes to toggle
=====================================
Brief: Specify which two themes to toggle between when using the command
@ -913,7 +883,7 @@ Brief: Specify which two themes to toggle between when using the command

File: modus-themes.info, Node: Option for which themes to rotate, Next: Mixed fonts, Prev: Option for which themes to toggle, Up: Customization options
4.6 Option for which themes to rotate
4.5 Option for which themes to rotate
=====================================
[ Default value and behaviour changed as part of 5.0.0-dev. ]
@ -942,7 +912,7 @@ function modus-themes-get-themes.

File: modus-themes.info, Node: Mixed fonts, Next: Command prompts, Prev: Option for which themes to rotate, Up: Customization options
4.7 Option for font mixing
4.6 Option for font mixing
==========================
Brief: Toggle the use of monospaced fonts for spacing-sensitive
@ -971,7 +941,7 @@ for Org and others.

File: modus-themes.info, Node: Command prompts, Next: Completion UIs, Prev: Mixed fonts, Up: Customization options
4.8 Option for command prompt styles
4.7 Option for command prompt styles
====================================
Brief: Control the style of command prompts (e.g. minibuffer, shell,
@ -1028,7 +998,7 @@ less colorful.

File: modus-themes.info, Node: Completion UIs, Next: Org mode blocks, Prev: Command prompts, Up: Customization options
4.9 Option for completion framework aesthetics
4.8 Option for completion framework aesthetics
==============================================
Brief: Set the overall style of completion framework interfaces.
@ -1094,8 +1064,8 @@ completion matches more or less colorful.

File: modus-themes.info, Node: Org mode blocks, Next: Heading styles, Prev: Completion UIs, Up: Customization options
4.10 Option for org-mode block styles
=====================================
4.9 Option for org-mode block styles
====================================
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
@ -1109,7 +1079,7 @@ language::).

File: modus-themes.info, Node: Heading styles, Next: UI typeface, Prev: Org mode blocks, Up: Customization options
4.11 Option for the headings' overall style
4.10 Option for the headings' overall style
===========================================
Brief: Heading styles with optional list of values per heading level.
@ -1222,7 +1192,7 @@ less colorful.

File: modus-themes.info, Node: UI typeface, Next: Palette overrides, Prev: Heading styles, Up: Customization options
4.12 Option for variable-pitch font in UI elements
4.11 Option for variable-pitch font in UI elements
==================================================
Brief: Toggle the use of proportionately spaced (variable-pitch) fonts
@ -1252,7 +1222,7 @@ for Org and others.

File: modus-themes.info, Node: Palette overrides, Next: Palette extension, Prev: UI typeface, Up: Customization options
4.13 Option for palette overrides
4.12 Option for palette overrides
=================================
This section describes palette overrides in detail. For a simpler
@ -1348,8 +1318,8 @@ 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. 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
@ -1370,7 +1340,7 @@ watch:

File: modus-themes.info, Node: Palette extension, Prev: Palette overrides, Up: Customization options
4.14 Option to extend the palette
4.13 Option to extend the palette
=================================
It is possible to extend the palette of each theme. For example, the
@ -6680,7 +6650,6 @@ B.2 Variable index
* modus-themes-common-palette-overrides: Palette overrides. (line 22)
* modus-themes-common-palette-user: Palette extension. (line 16)
* modus-themes-completions: Completion UIs. (line 6)
* modus-themes-custom-auto-reload: Custom reload theme. (line 6)
* modus-themes-custom-variables: Build on top of the Modus themes.
(line 56)
* modus-themes-disable-other-themes: Disable other themes. (line 6)
@ -6789,134 +6758,133 @@ B.3 Concept index

Tag Table:
Node: Top874
Node: Overview8654
Node: How do the themes look like11420
Node: Learn about the latest changes11779
Node: Installation12167
Node: Install manually from source13078
Node: Install from the archives13901
Node: Install on GNU/Linux14500
Node: Debian 11 Bullseye14991
Node: GNU Guix15399
Node: Dealing with byte compilation errors15682
Node: Enable and load16840
Node: The require-theme for built-in Emacs themes20835
Node: Sample configuration21752
Node: Differences between loading and enabling24028
Node: Customization options26093
Node: Custom reload theme30002
Node: Disable other themes30922
Node: Bold constructs32224
Node: Italic constructs33096
Node: Option for which themes to toggle33924
Node: Option for which themes to rotate34687
Node: Mixed fonts35751
Node: Command prompts36805
Node: Completion UIs38646
Node: Org mode blocks41495
Node: Heading styles42140
Node: UI typeface46566
Node: Palette overrides47539
Node: Palette extension51925
Node: Preview theme colors54401
Node: Use colors from the Modus themes palette55952
Node: Get a single color from the palette with modus-themes-get-color-value56816
Node: Use theme colors in code with modus-themes-with-colors59177
Node: Advanced customization61431
Node: DIY Palette override presets63209
Node: DIY Add support for engrave-faces66043
Node: DIY Stylistic variants using palette overrides76026
Node: DIY Make the mode line borderless78085
Node: DIY Make the active mode line colorful79460
Node: DIY Make the tab bar more or less colorful81678
Node: DIY Make the fringe invisible or another color83615
Node: DIY Make links use subtle or no underlines84812
Node: DIY Make prompts more or less colorful85930
Node: DIY Make completion matches more or less colorful87253
Node: DIY Make comments yellow and strings green90812
Node: DIY Make code syntax use the old alt-syntax style92519
Node: DIY Make use of alternative styles for code syntax95632
Node: DIY Make matching parenthesis more or less intense99094
Node: DIY Make box buttons more or less gray100466
Node: DIY Make TODO and DONE more or less intense101479
Node: DIY Make headings more or less colorful102980
Node: DIY Make Org block colors more or less colorful105097
Node: DIY Make Org agenda more or less colorful109469
Node: DIY Make inline code in prose use alternative styles112644
Node: DIY Make mail citations and headers more or less colorful114884
Node: DIY Make the region preserve text colors plus other styles117284
Node: DIY Make mouse highlights more or less colorful118840
Node: DIY Make language underlines less colorful119853
Node: DIY Make line numbers use alternative styles121005
Node: DIY Make diffs use only a foreground122648
Node: DIY Make deuteranopia diffs red and blue instead of yellow and blue125535
Node: DIY More accurate colors in terminal emulators128007
Node: DIY Range of color with terminal emulators129315
Node: DIY Per-theme customization settings132102
Node: DIY Do not extend the region background133535
Node: DIY Add padding to the mode line134333
Node: DIY Remap face with local value137261
Node: DIY Font configurations for Org and others139800
Ref: DIY Font configurations for Org and others-Footnote-1142783
Node: DIY Configure bold and italic faces142970
Node: DIY Custom Org todo keyword and priority faces147592
Node: DIY Custom Org emphasis faces151333
Node: DIY Use colored Org source blocks per language156210
Node: DIY Measure color contrast160850
Node: DIY Load theme depending on time of day163567
Node: DIY Backdrop for pdf-tools164595
Node: DIY Toggle themes without reloading them167756
Node: DIY Use more spacious margins or padding in Emacs frames169065
Node: DIY Custom hl-todo colors173302
Node: DIY Add support for solaire-mode175119
Node: DIY Add support for meow-mode178211
Node: DIY Add support for combobulate180021
Node: DIY Use a hook at the post-load-theme phase183644
Node: DIY A theme-agnostic hook for theme loading185765
Node: Build on top of the Modus themes188396
Node: Face coverage196203
Node: Supported packages196665
Node: Indirectly covered packages202531
Node: Notes on individual packages203887
Node: Note on calendarel weekday and weekend colors204989
Node: Note on git-gutter in Doom Emacs206139
Node: Note on php-mode multiline comments208641
Node: Note on underlines in compilation buffers209403
Node: Note on inline Latex in Org buffers210277
Node: Note on dimmerel210889
Node: Note on display-fill-column-indicator-mode212376
Node: Note on highlight-parenthesesel213829
Node: Note on mmm-modeel background colors219908
Node: Note for prism222262
Node: Note on company-mode overlay pop-up225476
Ref: Note on company-mode overlay pop-up-Footnote-1226206
Ref: Note on company-mode overlay pop-up-Footnote-2226273
Node: Note on ERC escaped color sequences226328
Ref: Note on ERC escaped color sequences-Footnote-1227758
Node: Note on powerline or spaceline227868
Node: Note on SHR colors228284
Node: Note on SHR fonts228706
Node: Note on Ement colors and fonts229395
Node: Note on pdf-tools link hints230901
Node: Note on the Notmuch logo233359
Node: Note on goto-address-mode faces233893
Node: Frequently Asked Questions235013
Node: Is the contrast ratio about adjacent colors?235644
Node: What does it mean to avoid exaggerations?237153
Node: Why are colors mostly variants of blue magenta cyan?239003
Node: What is the best setup for legibility?243337
Node: Are these color schemes?245979
Node: Port the Modus themes to other platforms?249633
Node: Contributing252467
Node: Sources of the themes252866
Node: Issues you can help with253762
Node: Patches require copyright assignment to the FSF255154
Node: Acknowledgements257376
Node: GNU Free Documentation License261821
Node: Indices286984
Node: Function index287163
Node: Variable index290651
Node: Concept index294744
Node: Overview8559
Node: How do the themes look like11325
Node: Learn about the latest changes11684
Node: Installation12072
Node: Install manually from source12983
Node: Install from the archives13806
Node: Install on GNU/Linux14405
Node: Debian 11 Bullseye14896
Node: GNU Guix15304
Node: Dealing with byte compilation errors15587
Node: Enable and load16745
Node: The require-theme for built-in Emacs themes20740
Node: Sample configuration21657
Node: Differences between loading and enabling23933
Node: Customization options25998
Node: Disable other themes29767
Node: Bold constructs31041
Node: Italic constructs31913
Node: Option for which themes to toggle32741
Node: Option for which themes to rotate33504
Node: Mixed fonts34568
Node: Command prompts35622
Node: Completion UIs37463
Node: Org mode blocks40312
Node: Heading styles40955
Node: UI typeface45381
Node: Palette overrides46354
Node: Palette extension50711
Node: Preview theme colors53187
Node: Use colors from the Modus themes palette54738
Node: Get a single color from the palette with modus-themes-get-color-value55602
Node: Use theme colors in code with modus-themes-with-colors57963
Node: Advanced customization60217
Node: DIY Palette override presets61995
Node: DIY Add support for engrave-faces64829
Node: DIY Stylistic variants using palette overrides74812
Node: DIY Make the mode line borderless76871
Node: DIY Make the active mode line colorful78246
Node: DIY Make the tab bar more or less colorful80464
Node: DIY Make the fringe invisible or another color82401
Node: DIY Make links use subtle or no underlines83598
Node: DIY Make prompts more or less colorful84716
Node: DIY Make completion matches more or less colorful86039
Node: DIY Make comments yellow and strings green89598
Node: DIY Make code syntax use the old alt-syntax style91305
Node: DIY Make use of alternative styles for code syntax94418
Node: DIY Make matching parenthesis more or less intense97880
Node: DIY Make box buttons more or less gray99252
Node: DIY Make TODO and DONE more or less intense100265
Node: DIY Make headings more or less colorful101766
Node: DIY Make Org block colors more or less colorful103883
Node: DIY Make Org agenda more or less colorful108255
Node: DIY Make inline code in prose use alternative styles111430
Node: DIY Make mail citations and headers more or less colorful113670
Node: DIY Make the region preserve text colors plus other styles116070
Node: DIY Make mouse highlights more or less colorful117626
Node: DIY Make language underlines less colorful118639
Node: DIY Make line numbers use alternative styles119791
Node: DIY Make diffs use only a foreground121434
Node: DIY Make deuteranopia diffs red and blue instead of yellow and blue124321
Node: DIY More accurate colors in terminal emulators126793
Node: DIY Range of color with terminal emulators128101
Node: DIY Per-theme customization settings130888
Node: DIY Do not extend the region background132321
Node: DIY Add padding to the mode line133119
Node: DIY Remap face with local value136047
Node: DIY Font configurations for Org and others138586
Ref: DIY Font configurations for Org and others-Footnote-1141569
Node: DIY Configure bold and italic faces141756
Node: DIY Custom Org todo keyword and priority faces146378
Node: DIY Custom Org emphasis faces150119
Node: DIY Use colored Org source blocks per language154996
Node: DIY Measure color contrast159636
Node: DIY Load theme depending on time of day162353
Node: DIY Backdrop for pdf-tools163381
Node: DIY Toggle themes without reloading them166542
Node: DIY Use more spacious margins or padding in Emacs frames167851
Node: DIY Custom hl-todo colors172088
Node: DIY Add support for solaire-mode173905
Node: DIY Add support for meow-mode176997
Node: DIY Add support for combobulate178807
Node: DIY Use a hook at the post-load-theme phase182430
Node: DIY A theme-agnostic hook for theme loading184551
Node: Build on top of the Modus themes187182
Node: Face coverage194989
Node: Supported packages195451
Node: Indirectly covered packages201317
Node: Notes on individual packages202673
Node: Note on calendarel weekday and weekend colors203775
Node: Note on git-gutter in Doom Emacs204925
Node: Note on php-mode multiline comments207427
Node: Note on underlines in compilation buffers208189
Node: Note on inline Latex in Org buffers209063
Node: Note on dimmerel209675
Node: Note on display-fill-column-indicator-mode211162
Node: Note on highlight-parenthesesel212615
Node: Note on mmm-modeel background colors218694
Node: Note for prism221048
Node: Note on company-mode overlay pop-up224262
Ref: Note on company-mode overlay pop-up-Footnote-1224992
Ref: Note on company-mode overlay pop-up-Footnote-2225059
Node: Note on ERC escaped color sequences225114
Ref: Note on ERC escaped color sequences-Footnote-1226544
Node: Note on powerline or spaceline226654
Node: Note on SHR colors227070
Node: Note on SHR fonts227492
Node: Note on Ement colors and fonts228181
Node: Note on pdf-tools link hints229687
Node: Note on the Notmuch logo232145
Node: Note on goto-address-mode faces232679
Node: Frequently Asked Questions233799
Node: Is the contrast ratio about adjacent colors?234430
Node: What does it mean to avoid exaggerations?235939
Node: Why are colors mostly variants of blue magenta cyan?237789
Node: What is the best setup for legibility?242123
Node: Are these color schemes?244765
Node: Port the Modus themes to other platforms?248419
Node: Contributing251253
Node: Sources of the themes251652
Node: Issues you can help with252548
Node: Patches require copyright assignment to the FSF253940
Node: Acknowledgements256162
Node: GNU Free Documentation License260607
Node: Indices285770
Node: Function index285949
Node: Variable index289437
Node: Concept index293457

End Tag Table

View file

@ -536,7 +536,6 @@ reloaded for changes to take effect.
modus-themes-bold-constructs nil
modus-themes-mixed-fonts t
modus-themes-variable-pitch-ui nil
modus-themes-custom-auto-reload t
modus-themes-disable-other-themes t
;; Options for `modus-themes-prompts' are either nil (the
@ -573,34 +572,6 @@ reloaded for changes to take effect.
;; document extensively in this manual.
#+end_src
** Option for reloading the theme on custom change
:properties:
:alt_title: Custom reload theme
:description: Toggle auto-reload of the theme when setting custom variables
:custom_id: h:9001527a-4e2c-43e0-98e8-3ef72d770639
:end:
#+vindex: modus-themes-custom-auto-reload
Brief: Toggle reloading of the active theme when an option is changed
through the Custom UI.
Symbol: ~modus-themes-custom-auto-reload~ (=boolean= type)
Possible values:
1. ~nil~
2. ~t~ (default)
All theme user options take effect when a theme is loaded. Any
subsequent changes require the theme to be reloaded.
When this variable has a non-~nil~ value, any change made via the Custom
UI or related functions such as ~customize-set-variable~ and ~setopt~
(Emacs 29), will trigger a reload automatically.
With a ~nil~ value, changes to user options have no further consequences:
the user must manually reload the theme ([[#h:3f3c3728-1b34-437d-9d0c-b110f5b161a9][Enable and load]]).
** Option for disabling other themes while loading Modus
:properties:
:alt_title: Disable other themes
@ -1194,8 +1165,8 @@ a cyan hue to keywords:
(keyword cyan-cooler)))
#+end_src
Changes take effect upon theme reload ([[#h:9001527a-4e2c-43e0-98e8-3ef72d770639][Custom reload theme]]).
Overrides are removed by setting their variable to a ~nil~ value.
Changes take effect upon theme reload. 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

View file

@ -229,23 +229,9 @@ text should not be underlined as well) yet still blend in."
;;;; Customization variables
(defcustom modus-themes-custom-auto-reload t
"Automatically reload theme after setting options with Customize.
All theme user options take effect when a theme is loaded. Any
subsequent changes require the theme to be reloaded.
When this variable has a non-nil value, any change made via the
Custom UI or related functions such as `customize-set-variable'
and `setopt' (Emacs 29), will trigger a reload automatically.
With a nil value, changes to user options have no further
consequences. The user must manually reload the theme."
:group 'modus-themes
:package-version '(modus-themes . "4.0.0")
:version "30.1"
:type 'boolean
:link '(info-link "(modus-themes) Custom reload theme"))
(make-obsolete-variable
'modus-themes-custom-auto-reload nil
"5.0.0; just reload the theme manually")
(defcustom modus-themes-disable-other-themes t
"Disable all other themes when loading a Modus theme.