[elpa] externals/modus-themes df7749bbed: Reword some statements about frame padding

[ELPA Syncer]

branch: externals/modus-themes
commit df7749bbedd2fcbc4f7119df3eb61c84f124f128
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Reword some statements about frame padding
---
 doc/modus-themes.info | 258 +++++++++++++++++++++++++-------------------------
 doc/modus-themes.org  |   8 +-
 2 files changed, 135 insertions(+), 131 deletions(-)

diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 4dbcef5465..24ada5299b 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -140,7 +140,7 @@ Advanced customization
 * Backdrop for pdf-tools::
 * Toggle themes without reloading them::
 * A theme-agnostic hook for theme loading::
-* Use more spacious padding in Emacs frames::
+* Use more spacious margins or padding in Emacs frames::
 * Custom hl-todo colors::
 * Add support for solaire-mode::
 
@@ -1336,7 +1336,7 @@ such, they are labeled as “do-it-yourself” or “DIY”.
 * Backdrop for pdf-tools::
 * Toggle themes without reloading them::
 * A theme-agnostic hook for theme loading::
-* Use more spacious padding in Emacs frames::
+* Use more spacious margins or padding in Emacs frames::
 * Custom hl-todo colors::
 * Add support for solaire-mode::
 
@@ -3664,7 +3664,7 @@ their own command which calls ‘enable-theme’ instead of 
‘load-theme’:
    Recall that ‘modus-themes-toggle’ uses ‘load-theme’.
 
 
-File: modus-themes.info,  Node: A theme-agnostic hook for theme loading,  
Next: Use more spacious padding in Emacs frames,  Prev: Toggle themes without 
reloading them,  Up: Advanced customization
+File: modus-themes.info,  Node: A theme-agnostic hook for theme loading,  
Next: Use more spacious margins or padding in Emacs frames,  Prev: Toggle 
themes without reloading them,  Up: Advanced customization
 
 5.21 A theme-agnostic hook for theme loading
 ============================================
@@ -3715,10 +3715,10 @@ 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: Use more spacious padding in Emacs frames,  
Next: Custom hl-todo colors,  Prev: A theme-agnostic hook for theme loading,  
Up: Advanced customization
+File: modus-themes.info,  Node: Use more spacious margins or padding in Emacs 
frames,  Next: Custom hl-todo colors,  Prev: A theme-agnostic hook for theme 
loading,  Up: Advanced customization
 
-5.22 Use more spacious padding in Emacs frames
-==============================================
+5.22 Use more spacious margins or padding in Emacs frames
+=========================================================
 
 By default, Emacs frames try to maximize the number of characters that
 fit in the current visible portion of the buffer.  Users may prefer to
@@ -3728,8 +3728,8 @@ window.
 
    The way to implement such padding is two-fold:
 
-  1. Instrument Emacs to use a higher value for the
-     ‘internal-border-width’ of all frames, as well as for the
+  1. In the ‘early-init.el’ file instruct Emacs to use a higher value
+     for the ‘internal-border-width’ of all frames, as well as for the
      ‘right-divider-width’.  The former concerns the outer boundaries of
      Emacs frames, while the latter pertains to dividers between Emacs
      windows.
@@ -3747,6 +3747,8 @@ creates (unless those are explicitly overridden by a 
bespoke
    In detail, first we use the same values for the two frame alist
 variables:
 
+     ;; This must go in the early-init.el so that it applies to the initial
+     ;; frame.
      (dolist (var '(default-frame-alist initial-frame-alist))
        (add-to-list var '(right-divider-width . 20))
        (add-to-list var '(internal-border-width . 20)))
@@ -3794,7 +3796,7 @@ defining their own theme-agnostic hook (*note A 
theme-agnostic hook for
 theme loading::).
 
 
-File: modus-themes.info,  Node: Custom hl-todo colors,  Next: Add support for 
solaire-mode,  Prev: Use more spacious padding in Emacs frames,  Up: Advanced 
customization
+File: modus-themes.info,  Node: Custom hl-todo colors,  Next: Add support for 
solaire-mode,  Prev: Use more spacious margins or padding in Emacs frames,  Up: 
Advanced customization
 
 5.23 Custom hl-todo colors
 ==========================
@@ -6119,125 +6121,125 @@ B.3 Concept index
 
 Tag Table:
 Node: Top874
-Node: Overview8118
-Node: How do the themes look like10516
-Node: Learn about the latest changes10875
-Node: Installation11263
-Node: Install manually from source12193
-Node: Install from the archives13018
-Node: Install on GNU/Linux13617
-Node: Debian 11 Bullseye14110
-Node: GNU Guix14520
-Node: Dealing with byte compilation errors14803
-Node: Enable and load15961
-Node: The require-theme for built-in Emacs themes18815
-Node: Sample configuration with and without use-package19935
-Node: Differences between loading and enabling22846
-Node: Customization options24884
-Node: Custom reload theme28632
-Node: Disable other themes29540
-Node: Bold constructs30720
-Node: Italic constructs31557
-Node: Mixed fonts32328
-Node: Command prompts33324
-Node: Completion UIs35129
-Node: Org mode blocks37919
-Node: Heading styles39799
-Node: UI typeface44153
-Node: Palette overrides45084
-Node: Advanced customization49305
-Node: Palette override presets50957
-Node: Stylistic variants using palette overrides53831
-Node: Make the mode line borderless55743
-Node: Make the active mode line colorful57345
-Node: Make the tab bar more or less colorful59290
-Node: Make the fringe invisible or another color61521
-Node: Make links use subtle or no underlines63015
-Node: Make prompts more or less colorful64012
-Node: Make completion matches more or less colorful65676
-Node: Make comments yellow and strings green69576
-Node: Make code syntax use the old alt-syntax style71479
-Node: Make use of alternative styles for code syntax74760
-Node: Make matching parenthesis more or less intense78424
-Node: Make box buttons more or less gray79860
-Node: Make TODO and DONE more or less intense81166
-Node: Make headings more or less colorful82869
-Node: Make Org agenda more or less colorful85269
-Node: Make inline code in prose use alternative styles88729
-Node: Make mail citations and headers more or less colorful91270
-Node: Make the region preserve text colors plus other styles93965
-Node: Make mouse highlights more or less colorful95776
-Node: Make language underlines less colorful97083
-Node: Make line numbers use alternative styles98529
-Node: Make diffs use only a foreground100466
-Node: Make deuteranopia diffs red and blue instead of yellow and blue103237
-Node: Make the themes look like what the maintainer uses105659
-Node: More accurate colors in terminal emulators110357
-Node: Range of color with terminal emulators111649
-Node: Preview theme colors114363
-Node: Per-theme customization settings116208
-Node: Get a single color from the palette117554
-Node: Use theme colors in code with modus-themes-with-colors119863
-Node: Do not extend the region background122196
-Node: Add padding to mode line122994
-Node: Remap face with local value125552
-Node: Font configurations for Org and others127975
-Ref: Font configurations for Org and others-Footnote-1130884
-Node: Configure bold and italic faces131071
-Node: Custom Org todo keyword and priority faces135228
-Node: Custom Org emphasis faces138793
-Node: Update Org block delimiter fontification143616
-Node: Measure color contrast145533
-Node: Load theme depending on time of day148231
-Node: Backdrop for pdf-tools149241
-Node: Toggle themes without reloading them152140
-Node: A theme-agnostic hook for theme loading153416
-Node: Use more spacious padding in Emacs frames155858
-Node: Custom hl-todo colors159570
-Node: Add support for solaire-mode161097
-Node: Face coverage164008
-Node: Supported packages164460
-Node: Indirectly covered packages169973
-Node: Notes on individual packages171326
-Node: Note on calendarel weekday and weekend colors172426
-Node: Note on git-gutter in Doom Emacs173574
-Node: Note on php-mode multiline comments175915
-Node: Note on underlines in compilation buffers176668
-Node: Note on inline Latex in Org buffers177505
-Node: Note on dimmerel178115
-Node: Note on display-fill-column-indicator-mode179600
-Node: Note on highlight-parenthesesel180999
-Node: Note on mmm-modeel background colors186977
-Node: Note for prism189277
-Node: Note on company-mode overlay pop-up192445
-Ref: Note on company-mode overlay pop-up-Footnote-1193175
-Ref: Note on company-mode overlay pop-up-Footnote-2193242
-Node: Note on ERC escaped color sequences193297
-Ref: Note on ERC escaped color sequences-Footnote-1194725
-Node: Note on powerline or spaceline194835
-Node: Note on SHR colors195249
-Node: Note on SHR fonts195673
-Node: Note on Ement colors and fonts196312
-Node: Note on pdf-tools link hints197822
-Node: Note on the Notmuch logo200282
-Node: Note on goto-address-mode faces200820
-Node: Frequently Asked Questions201932
-Node: Is the contrast ratio about adjacent colors?202563
-Node: What does it mean to avoid exaggerations?204070
-Node: Why are colors mostly variants of blue magenta cyan?205920
-Node: What is the best setup for legibility?210226
-Node: Are these color schemes?212871
-Node: Port the Modus themes to other platforms?216553
-Node: Contributing219325
-Node: Sources of the themes219722
-Node: Issues you can help with220616
-Node: Patches require copyright assignment to the FSF222007
-Node: Acknowledgements224227
-Node: GNU Free Documentation License228269
-Node: Indices253633
-Node: Function index253812
-Node: Variable index254995
-Node: Concept index257174
+Node: Overview8129
+Node: How do the themes look like10527
+Node: Learn about the latest changes10886
+Node: Installation11274
+Node: Install manually from source12204
+Node: Install from the archives13029
+Node: Install on GNU/Linux13628
+Node: Debian 11 Bullseye14121
+Node: GNU Guix14531
+Node: Dealing with byte compilation errors14814
+Node: Enable and load15972
+Node: The require-theme for built-in Emacs themes18826
+Node: Sample configuration with and without use-package19946
+Node: Differences between loading and enabling22857
+Node: Customization options24895
+Node: Custom reload theme28643
+Node: Disable other themes29551
+Node: Bold constructs30731
+Node: Italic constructs31568
+Node: Mixed fonts32339
+Node: Command prompts33335
+Node: Completion UIs35140
+Node: Org mode blocks37930
+Node: Heading styles39810
+Node: UI typeface44164
+Node: Palette overrides45095
+Node: Advanced customization49316
+Node: Palette override presets50979
+Node: Stylistic variants using palette overrides53853
+Node: Make the mode line borderless55765
+Node: Make the active mode line colorful57367
+Node: Make the tab bar more or less colorful59312
+Node: Make the fringe invisible or another color61543
+Node: Make links use subtle or no underlines63037
+Node: Make prompts more or less colorful64034
+Node: Make completion matches more or less colorful65698
+Node: Make comments yellow and strings green69598
+Node: Make code syntax use the old alt-syntax style71501
+Node: Make use of alternative styles for code syntax74782
+Node: Make matching parenthesis more or less intense78446
+Node: Make box buttons more or less gray79882
+Node: Make TODO and DONE more or less intense81188
+Node: Make headings more or less colorful82891
+Node: Make Org agenda more or less colorful85291
+Node: Make inline code in prose use alternative styles88751
+Node: Make mail citations and headers more or less colorful91292
+Node: Make the region preserve text colors plus other styles93987
+Node: Make mouse highlights more or less colorful95798
+Node: Make language underlines less colorful97105
+Node: Make line numbers use alternative styles98551
+Node: Make diffs use only a foreground100488
+Node: Make deuteranopia diffs red and blue instead of yellow and blue103259
+Node: Make the themes look like what the maintainer uses105681
+Node: More accurate colors in terminal emulators110379
+Node: Range of color with terminal emulators111671
+Node: Preview theme colors114385
+Node: Per-theme customization settings116230
+Node: Get a single color from the palette117576
+Node: Use theme colors in code with modus-themes-with-colors119885
+Node: Do not extend the region background122218
+Node: Add padding to mode line123016
+Node: Remap face with local value125574
+Node: Font configurations for Org and others127997
+Ref: Font configurations for Org and others-Footnote-1130906
+Node: Configure bold and italic faces131093
+Node: Custom Org todo keyword and priority faces135250
+Node: Custom Org emphasis faces138815
+Node: Update Org block delimiter fontification143638
+Node: Measure color contrast145555
+Node: Load theme depending on time of day148253
+Node: Backdrop for pdf-tools149263
+Node: Toggle themes without reloading them152162
+Node: A theme-agnostic hook for theme loading153438
+Node: Use more spacious margins or padding in Emacs frames155891
+Node: Custom hl-todo colors159757
+Node: Add support for solaire-mode161295
+Node: Face coverage164206
+Node: Supported packages164658
+Node: Indirectly covered packages170171
+Node: Notes on individual packages171524
+Node: Note on calendarel weekday and weekend colors172624
+Node: Note on git-gutter in Doom Emacs173772
+Node: Note on php-mode multiline comments176113
+Node: Note on underlines in compilation buffers176866
+Node: Note on inline Latex in Org buffers177703
+Node: Note on dimmerel178313
+Node: Note on display-fill-column-indicator-mode179798
+Node: Note on highlight-parenthesesel181197
+Node: Note on mmm-modeel background colors187175
+Node: Note for prism189475
+Node: Note on company-mode overlay pop-up192643
+Ref: Note on company-mode overlay pop-up-Footnote-1193373
+Ref: Note on company-mode overlay pop-up-Footnote-2193440
+Node: Note on ERC escaped color sequences193495
+Ref: Note on ERC escaped color sequences-Footnote-1194923
+Node: Note on powerline or spaceline195033
+Node: Note on SHR colors195447
+Node: Note on SHR fonts195871
+Node: Note on Ement colors and fonts196510
+Node: Note on pdf-tools link hints198020
+Node: Note on the Notmuch logo200480
+Node: Note on goto-address-mode faces201018
+Node: Frequently Asked Questions202130
+Node: Is the contrast ratio about adjacent colors?202761
+Node: What does it mean to avoid exaggerations?204268
+Node: Why are colors mostly variants of blue magenta cyan?206118
+Node: What is the best setup for legibility?210424
+Node: Are these color schemes?213069
+Node: Port the Modus themes to other platforms?216751
+Node: Contributing219523
+Node: Sources of the themes219920
+Node: Issues you can help with220814
+Node: Patches require copyright assignment to the FSF222205
+Node: Acknowledgements224425
+Node: GNU Free Documentation License228467
+Node: Indices253831
+Node: Function index254010
+Node: Variable index255193
+Node: Concept index257372
 
 End Tag Table
 
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index aa89fead69..e35c7e4890 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -3621,7 +3621,7 @@ In this document, we cover 
~modus-themes-after-load-theme-hook~ though
 the user can replace it with ~after-enable-theme-hook~ should they
 need to (provided they understand the implications).
 
-** Use more spacious padding in Emacs frames
+** Use more spacious margins or padding in Emacs frames
 :PROPERTIES:
 :CUSTOM_ID: h:43bcb5d0-e25f-470f-828c-662cee9e21f1
 :END:
@@ -3634,8 +3634,8 @@ window.
 
 The way to implement such padding is two-fold:
 
-1. Instrument Emacs to use a higher value for the
-   ~internal-border-width~ of all frames, as well as for the
+1. In the =early-init.el= file instruct Emacs to use a higher value
+   for the ~internal-border-width~ of all frames, as well as for the
    ~right-divider-width~.  The former concerns the outer boundaries of
    Emacs frames, while the latter pertains to dividers between Emacs
    windows.
@@ -3653,6 +3653,8 @@ bespoke ~make-frame~ call).
 In detail, first we use the same values for the two frame alist variables:
 
 #+begin_src emacs-lisp
+;; This must go in the early-init.el so that it applies to the initial
+;; frame.
 (dolist (var '(default-frame-alist initial-frame-alist))
   (add-to-list var '(right-divider-width . 20))
   (add-to-list var '(internal-border-width . 20)))