Reword docs for no font mixing option

2 files changed, 54 insertions, 54 deletions

diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 6815027..8647855 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -565,14 +565,14 @@ Symbol names:
 as Org tables and code blocks, to always inherit from the ‘fixed-pitch’
 face.  This is to ensure that those constructs remain monospaced when
 users opt for something like the built-in ‘M-x variable-pitch-mode’.
-Otherwise the layout would break.
+Otherwise the layout would appear broken.  To disable this behaviour,
+set the option to ‘t’.
 
-   The obvious downside with this theme design is that users need to
-explicitly configure the font family of ‘fixed-pitch’ in order to apply
-their desired typeface (see *note Font configurations for Org (and
-others): Font configs (DIY).). That may be something they do not want to
-do.  Hence this option to disable any kind of technique for mixing
-fonts.
+   Users may prefer to use another package for handling mixed typeface
+configurations, rather than letting the theme do it, perhaps because a
+purpose-specific package has extra functionality.  Two possible options
+are org-variable-pitch (https://melpa.org/#/org-variable-pitch) and
+mixed-pitch (https://melpa.org/#/mixed-pitch).
 
 
 File: modus-themes.info,  Node: Link underline,  Next: Command prompts,  Prev: No mixed fonts,  Up: Customisation Options
@@ -2440,47 +2440,47 @@ Node: Bold constructs17641
 Node: Slanted constructs18640
 Node: Syntax highlighting19231
 Node: No mixed fonts19959
-Node: Link underline21007
-Node: Command prompts21489
-Node: Mode line22287
-Node: Completion UIs24911
-Node: Fringes26823
-Node: Line highlighting27587
-Node: Matching parentheses28255
-Node: Diffs28899
-Node: Org mode blocks30692
-Node: Heading styles32195
-Node: Scaled headings35584
-Node: Scaled heading sizes36201
-Node: Headings' font38160
-Node: Advanced customisation (do-it-yourself)38784
-Node: Tweak colours (DIY)39788
-Node: Font configs (DIY)43422
-Ref: Font configs (DIY)-Footnote-146002
-Ref: Font configs (DIY)-Footnote-246189
-Node: Org user faces (DIY)46411
-Node: Face coverage49632
-Node: Supported packages50134
-Node: Covered indirectly56156
-Node: Will NOT be supported56541
-Node: Notes for individual packages57259
-Node: Note on company-mode overlay pop-up57747
-Ref: Note on company-mode overlay pop-up-Footnote-158411
-Ref: Note on company-mode overlay pop-up-Footnote-258478
-Node: Note for ERC escaped colour sequences58533
-Ref: Note for ERC escaped colour sequences-Footnote-159960
-Node: Note for powerline or spaceline60070
-Node: Note on shr colours60488
-Node: Note for Helm grep60901
-Node: Note on vc-annotate-background-mode62348
-Node: Contributing63202
-Node: Sources of the themes63621
-Node: Issues you can help with64383
-Node: Merge requests65570
-Node: Acknowledgements66652
-Node: Meta67935
-Node: External projects (ports)69127
-Node: GNU Free Documentation License69950
+Node: Link underline21040
+Node: Command prompts21522
+Node: Mode line22320
+Node: Completion UIs24944
+Node: Fringes26856
+Node: Line highlighting27620
+Node: Matching parentheses28288
+Node: Diffs28932
+Node: Org mode blocks30725
+Node: Heading styles32228
+Node: Scaled headings35617
+Node: Scaled heading sizes36234
+Node: Headings' font38193
+Node: Advanced customisation (do-it-yourself)38817
+Node: Tweak colours (DIY)39821
+Node: Font configs (DIY)43455
+Ref: Font configs (DIY)-Footnote-146035
+Ref: Font configs (DIY)-Footnote-246222
+Node: Org user faces (DIY)46444
+Node: Face coverage49665
+Node: Supported packages50167
+Node: Covered indirectly56189
+Node: Will NOT be supported56574
+Node: Notes for individual packages57292
+Node: Note on company-mode overlay pop-up57780
+Ref: Note on company-mode overlay pop-up-Footnote-158444
+Ref: Note on company-mode overlay pop-up-Footnote-258511
+Node: Note for ERC escaped colour sequences58566
+Ref: Note for ERC escaped colour sequences-Footnote-159993
+Node: Note for powerline or spaceline60103
+Node: Note on shr colours60521
+Node: Note for Helm grep60934
+Node: Note on vc-annotate-background-mode62381
+Node: Contributing63235
+Node: Sources of the themes63654
+Node: Issues you can help with64416
+Node: Merge requests65603
+Node: Acknowledgements66685
+Node: Meta67968
+Node: External projects (ports)69160
+Node: GNU Free Documentation License69983
 
 End Tag Table
 
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index 546c196..f851f61 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -433,13 +433,13 @@ By default, the themes configure some spacing-sensitive faces, such as
 Org tables and code blocks, to always inherit from the =fixed-pitch= face.
 This is to ensure that those constructs remain monospaced when users opt
 for something like the built-in =M-x variable-pitch-mode=.  Otherwise the
-layout would break.
+layout would appear broken.  To disable this behaviour, set the option
+to =t=.
 
-The obvious downside with this theme design is that users need to
-explicitly configure the font family of =fixed-pitch= in order to apply
-their desired typeface (see [[#h:defcf4fc-8fa8-4c29-b12e-7119582cc929][Font configurations for Org (and others)]]).
-That may be something they do not want to do.  Hence this option to
-disable any kind of technique for mixing fonts.
+Users may prefer to use another package for handling mixed typeface
+configurations, rather than letting the theme do it, perhaps because a
+purpose-specific package has extra functionality.  Two possible options
+are [[https://melpa.org/#/org-variable-pitch][org-variable-pitch]] and [[https://melpa.org/#/mixed-pitch][mixed-pitch]].
 
 ** Option for no link underline
 :PROPERTIES: