[elpa] externals/modus-operandi-theme 63db2ad 052/153: Clarify recommended method for scaling headings

[Stefan Monnier]

branch: externals/modus-operandi-theme
commit 63db2ad376cebd5f9348c43425a28deffa6fe6fe
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Clarify recommended method for scaling headings
---
 doc/modus-themes.info | 57 ++++++++++++++++++++++++++++-----------------------
 doc/modus-themes.org  |  8 ++++++--
 2 files changed, 37 insertions(+), 28 deletions(-)

diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 0dcf2ce..9734340 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -879,10 +879,15 @@ In addition to toggles for enabling scaled headings, 
users can also
 specify a number of their own.
 
    • If it is a floating point, say, ‘1.5’, it is interpreted as a
-     multiple of the base font size.
+     multiple of the base font size.  This is the recommended method.
+
    • If it is an integer, it is read as an absolute font height.  The
      number is basically the point size multiplied by a hundred.  So if
-     you want it to be ‘18pt’ you must pass ‘180’.
+     you want it to be ‘18pt’ you must pass ‘180’.  Please understand
+     that setting an absolute value is discouraged, as it will break the
+     layout when you try to change font sizes with the built-in
+     ‘text-scale-adjust’ command (see *note Font configurations: Font
+     configs (DIY).).
 
    Below are the variables in their default values, using the floating
 point paradigm.  The numbers are very conservative, but you are free to
@@ -2277,30 +2282,30 @@ Node: Accented headings28666
 Node: Section headings29521
 Node: Scaled headings30706
 Node: Scaled heading sizes31325
-Node: Headings' font32998
-Node: Advanced customisation (do-it-yourself)33622
-Node: Tweak colours (DIY)34626
-Node: Font configs (DIY)38260
-Ref: Font configs (DIY)-Footnote-140842
-Ref: Font configs (DIY)-Footnote-241029
-Node: Org user faces (DIY)41251
-Node: Face coverage44083
-Node: Supported packages44585
-Node: Covered indirectly50507
-Node: Will NOT be supported50859
-Node: Notes for individual packages51577
-Node: Note for powerline or spaceline51983
-Node: Note on shr colours52355
-Node: Note for Helm grep52768
-Node: Note on vc-annotate-background-mode54215
-Node: Contributing55069
-Node: Sources of the themes55488
-Node: Issues you can help with56250
-Node: Merge requests57437
-Node: Acknowledgements58519
-Node: Meta59976
-Node: External projects (ports)61029
-Node: GNU Free Documentation License61852
+Node: Headings' font33284
+Node: Advanced customisation (do-it-yourself)33908
+Node: Tweak colours (DIY)34912
+Node: Font configs (DIY)38546
+Ref: Font configs (DIY)-Footnote-141128
+Ref: Font configs (DIY)-Footnote-241315
+Node: Org user faces (DIY)41537
+Node: Face coverage44369
+Node: Supported packages44871
+Node: Covered indirectly50793
+Node: Will NOT be supported51145
+Node: Notes for individual packages51863
+Node: Note for powerline or spaceline52269
+Node: Note on shr colours52641
+Node: Note for Helm grep53054
+Node: Note on vc-annotate-background-mode54501
+Node: Contributing55355
+Node: Sources of the themes55774
+Node: Issues you can help with56536
+Node: Merge requests57723
+Node: Acknowledgements58805
+Node: Meta60262
+Node: External projects (ports)61315
+Node: GNU Free Documentation License62138
 
 End Tag Table
 
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index 7ae2ba1..af24764 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -756,10 +756,14 @@ In addition to toggles for enabling scaled headings, 
users can also
 specify a number of their own.
 
 + If it is a floating point, say, =1.5=, it is interpreted as a multiple
-  of the base font size.
+  of the base font size.  This is the recommended method.
+
 + If it is an integer, it is read as an absolute font height.  The
   number is basically the point size multiplied by a hundred.  So if you
-  want it to be =18pt= you must pass =180=.
+  want it to be =18pt= you must pass =180=.  Please understand that setting
+  an absolute value is discouraged, as it will break the layout when you
+  try to change font sizes with the built-in =text-scale-adjust= command
+  (see [[#h:defcf4fc-8fa8-4c29-b12e-7119582cc929][Font configurations]]).
 
 Below are the variables in their default values, using the floating
 point paradigm.  The numbers are very conservative, but you are free to