Reword a statement in the manual

doc/modus-themes.info

@@ -4174,12 +4174,14 @@ such as ‘modus-themes-toggle’ and the others mentioned above.
 ‘enable-theme’ is called internally by ‘load-theme’, so the hook works
 everywhere.
 
-   Now this specific piece of Elisp may be simple for experienced users,
-but it is not easy to read for newcomers, including the author of the
-Modus themes for the first several months of their time as an Emacs
-user.  Hence our hesitation to recommend it as part of the standard
-setup of the Modus themes (it is generally a good idea to understand
-what the implications are of advising a function).
+   The downside of the theme-agnostic hook is that any functions added
+to it will likely not be able to benefit from macro calls that read the
+active theme, such as ‘modus-themes-with-colors’.  Not all Emacs themes
+have the same capabilities.
+
+   In this document, we always mention ‘modus-themes-post-load-hook’
+though the user can replace it with ‘after-enable-theme-hook’ should
+they need to (provided they understand the implications).
 
 
 File: modus-themes.info,  Node: Diffs with only the foreground,  Next: Ediff without diff color-coding,  Prev: A theme-agnostic hook for theme loading,  Up: Advanced customization
@@ -6992,57 +6994,57 @@ Node: Backdrop for pdf-tools162652
 Node: Decrease mode line height165504
 Node: Toggle themes without reloading them169626
 Node: A theme-agnostic hook for theme loading170905
-Node: Diffs with only the foreground173307
-Node: Ediff without diff color-coding176421
-Node: Near-monochrome syntax highlighting178560
-Node: Custom hl-todo colors187557
-Node: Add support for solaire-mode189078
-Node: Face coverage191996
-Node: Supported packages192448
-Node: Indirectly covered packages199107
-Node: Notes on individual packages200235
-Node: Note on calendarel weekday and weekend colors201379
-Node: Note on git-gutter in Doom Emacs202527
-Node: Note on php-mode multiline comments204615
-Node: Note on underlines in compilation buffers205368
-Node: Note on inline Latex in Org buffers206205
-Node: Note on dimmerel206815
-Node: Note on display-fill-column-indicator-mode208300
-Node: Note on highlight-parenthesesel209698
-Node: Note on mmm-modeel background colors215748
-Node: Note for prism218063
-Node: Note for god-mode221219
-Node: Note on company-mode overlay pop-up222823
-Ref: Note on company-mode overlay pop-up-Footnote-1223513
-Ref: Note on company-mode overlay pop-up-Footnote-2223580
-Node: Note on ERC escaped color sequences223635
-Ref: Note on ERC escaped color sequences-Footnote-1225063
-Node: Note on powerline or spaceline225173
-Node: Note on SHR colors225587
-Node: Note on SHR fonts226011
-Node: Note on Ement colors and fonts226650
-Node: Note on Helm grep228149
-Node: Note on pdf-tools link hints229619
-Node: Note on the Notmuch logo232066
-Node: Note on goto-address-mode faces232604
-Node: Frequently Asked Questions233716
-Node: Is the contrast ratio about adjacent colors?234347
-Node: What does it mean to avoid exaggerations?235854
-Node: Why are colors mostly variants of blue magenta cyan?237683
-Node: What is the best setup for legibility?241989
-Node: Are these color schemes?244634
-Node: Port the Modus themes to other platforms?248354
-Node: Contributing251135
-Node: Sources of the themes251532
-Node: Issues you can help with252231
-Node: Patches require copyright assignment to the FSF253803
-Node: Acknowledgements256023
-Node: Other notes about the project259676
-Node: GNU Free Documentation License262674
-Node: Indices288051
-Node: Function index288230
-Node: Variable index290033
-Node: Concept index292320
+Node: Diffs with only the foreground173360
+Node: Ediff without diff color-coding176474
+Node: Near-monochrome syntax highlighting178613
+Node: Custom hl-todo colors187610
+Node: Add support for solaire-mode189131
+Node: Face coverage192049
+Node: Supported packages192501
+Node: Indirectly covered packages199160
+Node: Notes on individual packages200288
+Node: Note on calendarel weekday and weekend colors201432
+Node: Note on git-gutter in Doom Emacs202580
+Node: Note on php-mode multiline comments204668
+Node: Note on underlines in compilation buffers205421
+Node: Note on inline Latex in Org buffers206258
+Node: Note on dimmerel206868
+Node: Note on display-fill-column-indicator-mode208353
+Node: Note on highlight-parenthesesel209751
+Node: Note on mmm-modeel background colors215801
+Node: Note for prism218116
+Node: Note for god-mode221272
+Node: Note on company-mode overlay pop-up222876
+Ref: Note on company-mode overlay pop-up-Footnote-1223566
+Ref: Note on company-mode overlay pop-up-Footnote-2223633
+Node: Note on ERC escaped color sequences223688
+Ref: Note on ERC escaped color sequences-Footnote-1225116
+Node: Note on powerline or spaceline225226
+Node: Note on SHR colors225640
+Node: Note on SHR fonts226064
+Node: Note on Ement colors and fonts226703
+Node: Note on Helm grep228202
+Node: Note on pdf-tools link hints229672
+Node: Note on the Notmuch logo232119
+Node: Note on goto-address-mode faces232657
+Node: Frequently Asked Questions233769
+Node: Is the contrast ratio about adjacent colors?234400
+Node: What does it mean to avoid exaggerations?235907
+Node: Why are colors mostly variants of blue magenta cyan?237736
+Node: What is the best setup for legibility?242042
+Node: Are these color schemes?244687
+Node: Port the Modus themes to other platforms?248407
+Node: Contributing251188
+Node: Sources of the themes251585
+Node: Issues you can help with252284
+Node: Patches require copyright assignment to the FSF253856
+Node: Acknowledgements256076
+Node: Other notes about the project259729
+Node: GNU Free Documentation License262727
+Node: Indices288104
+Node: Function index288283
+Node: Variable index290086
+Node: Concept index292373
 
 End Tag Table
 

doc/modus-themes.org

@@ -4138,12 +4138,14 @@ also has the benefit that it does not depend on functions such as
 ~modus-themes-toggle~ and the others mentioned above. ~enable-theme~ is
 called internally by ~load-theme~, so the hook works everywhere.
 
-Now this specific piece of Elisp may be simple for experienced users,
-but it is not easy to read for newcomers, including the author of the
-Modus themes for the first several months of their time as an Emacs
-user.  Hence our hesitation to recommend it as part of the standard
-setup of the Modus themes (it is generally a good idea to understand
-what the implications are of advising a function).
+The downside of the theme-agnostic hook is that any functions added to
+it will likely not be able to benefit from macro calls that read the
+active theme, such as ~modus-themes-with-colors~.  Not all Emacs
+themes have the same capabilities.
+
+In this document, we always mention ~modus-themes-post-load-hook~
+though the user can replace it with ~after-enable-theme-hook~ should
+they need to (provided they understand the implications).
 
 ** Diffs with only the foreground
 :properties: