branch: externals/spacious-padding
commit 9507cb206e1187c08574e8fa65c3fe6aeab84063
Author: Protesilaos Stavrou <[email protected]>
Commit: Protesilaos Stavrou <[email protected]>
Update the spacious-padding version 0.8.0
---
CHANGELOG.org | 102 ++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 16 +++------
spacious-padding.el | 2 +-
3 files changed, 108 insertions(+), 12 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index e00f7e6c12..544b1b9689 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -13,6 +13,108 @@ the manual:
<https://protesilaos.com/emacs/spacious-padding>.
#+toc: headlines 1 insert TOC here, with one headline level
+* Version 0.8.0 on 2025-12-13
+:PROPERTIES:
+:CUSTOM_ID: h:4a3250fa-b905-4bc4-bd22-7cb5690aef1b
+:END:
+
+This release introduces some nice refinements and fixes a couple of
+subtle bugs.
+
+** Subtle mode and header line
+:PROPERTIES:
+:CUSTOM_ID: h:76f3c771-e0a4-46c4-9002-c88e73aa8b84
+:END:
+
+The new user option ~spacious-padding-subtle-frame-lines~ supersedes
+the ~~spacious-padding-subtle-mode-line~. It does the same thing,
+namely, of making the mode lines use only a thin line instead of a
+background. Though it extends this feature to header lines as well.
+
+The documentation string of ~spacious-padding-subtle-frame-lines~
+describes the technicalities and includes examples. In short, we can
+associate a keyword with either a face that has a foreground color or
+a color value directly. For the convenience of the user, the package
+also defines the faces ~spacious-padding-line-active~ and
+~spacious-padding-line-inactive~. Here is a sample configuration:
+
+#+begin_src emacs-lisp
+;; Read the doc string of `spacious-padding-subtle-mode-line' as it
+;; is very flexible. Here we make the mode lines be a single
+;; overline, while header lines have an underline.
+(setq spacious-padding-subtle-frame-lines
+ '( :mode-line-active spacious-padding-line-active
+ :mode-line-inactive spacious-padding-line-inactive
+ :header-line-active spacious-padding-line-active
+ :header-line-inactive spacious-padding-line-inactive))
+#+end_src
+
+In the future, we might decide that other elements can benefit from
+this style.
+
+** The header line underline is spaced further away from the text
+:PROPERTIES:
+:CUSTOM_ID: h:fe3649fe-6c47-4d14-ae51-6583971fdb4c
+:END:
+
+As noted above, when ~spacious-padding-subtle-frame-lines~ is
+configured to cover header lines, those will be drawn with an
+underline. This will not intersect with the text of the header line.
+
+Normally, underlines cut through letters that descend below the
+baseline, such as the letters =g= and =y=. We choose to avoid that
+because it makes for a cleaner interface (though I personally think it
+is not a good style for paragraph text, because of the rivers of
+negative space it introduces).
+
+This specific design is available for Emacs version 29 or higher.
+Users of Emacs 28 must set ~x-underline-at-descent-line~ to a
+non-~nil~ value. Though note that this has a global effect: we cannot
+limit it to a single face.
+
+Thanks to Steven Allen for covering this in pull request 37:
+<https://github.com/protesilaos/spacious-padding/pull/37>. Steven has
+assigned copyright to the Free Software Foundation.
+
+** The ~spacious-padding-widths~ can affect Custom buttons
+:PROPERTIES:
+:CUSTOM_ID: h:240e1874-fc68-4e3d-890c-9fa27912edf9
+:END:
+
+This is about the buttons we find in buffers of the Custom system. For
+example, we get such a buffer after we do =M-x customize=.
+
+The relevant keyword is =:custom-button-width=. It is set to a number
+of spaces for padding. Here is the default value and, as always, the
+documentation cover the details:
+
+#+begin_src emacs-lisp
+(setq spacious-padding-widths
+ '( :internal-border-width 15
+ :header-line-width 4
+ :mode-line-width 6
+ :custom-button-width 3 ; the new one
+ :tab-width 4
+ :right-divider-width 30
+ :scroll-bar-width 8
+ :fringe-width 8))
+#+end_src
+
+** Fixes for the Emacs daemon
+:PROPERTIES:
+:CUSTOM_ID: h:902951ad-dd49-4716-ad67-dc7526f20ade
+:END:
+
+There were reports about incorrect face specifications that could
+happen when Emacs was started as a daemon process. I made the relevant
+changes. Also thanks to kaibagley for covering a line I had missed.
+This was done in pull request 43:
<https://github.com/protesilaos/spacious-padding/pull/43>.
+
+Related threads:
+
+- Issue 35, as reported by Chinmay Dalal:
<https://github.com/protesilaos/spacious-padding/issues/35>.
+- Issue 41, as reported by zealotrush:
<https://github.com/protesilaos/spacious-padding/issues/41>.
+
* Version 0.7.0 on 2025-06-01
:PROPERTIES:
:CUSTOM_ID: h:adc3093a-e4ae-4ce9-842b-16667a910cdd
diff --git a/README.org b/README.org
index 786057c1c8..d5de6c2176 100644
--- a/README.org
+++ b/README.org
@@ -4,9 +4,9 @@
#+language: en
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
-#+macro: stable-version 0.7.0
-#+macro: release-date 2025-06-01
-#+macro: development-version 0.8.0-dev
+#+macro: stable-version 0.8.0
+#+macro: release-date 2025-12-13
+#+macro: development-version 0.9.0-dev
#+export_file_name: spacious-padding.texi
#+texinfo_filename: spacious-padding.info
#+texinfo_dir_category: Emacs misc features
@@ -203,17 +203,13 @@ value is used). Keys are keywords among the following:
the ~header-line~, ~mode-line~, and ~scroll-bar~, respectively.
- ~:custom-button-width~ is for all buttons shown in the Custom User
- Interface and related. [ Part of {{{development-version}}}. ]
+ Interface and related.
** Make the mode and header lines subtle
:PROPERTIES:
:CUSTOM_ID: h:cffe3c7e-9f67-4147-8ada-edfcc4cf979e
:END:
-[ As part of {{{development-version}}}, the user option is now called
- ~spacious-padding-subtle-frame-lines~ instead of
~spacious-padding-subtle-mode-line~.
- Header line faces are covered as well. ]
-
#+vindex: spacious-padding-subtle-frame-lines
By default, ~spacious-padding-mode~ does not refashion the mode lines
or header lines other than adding to them some extra padding
([[#h:eb0ce65d-6b44-42db-ab22-aad3ac5c0c1b][Set the exact spacing values]]).
@@ -289,9 +285,7 @@ Examples of valid configurations:
#+vindex: spacious-padding-line-inactive
For the convenience of the user, we define the faces
~spacious-padding-line-active~ and ~spacious-paddinge-line-inactive~,
-which can be used as described above. [ These faces are the new names
-of the now-obsolete ~spacious-padding-subtle-mode-line-active~ and
-~spacious-padding-subtle-mode-line-inactive~ as part of
{{{development-version}}}. ]
+which can be used as described above.
Users of Emacs 28 need to set ~x-underline-at-descent-line~ to a non-nil
value to get the desired spacing with the underlines. Newer versions of
diff --git a/spacious-padding.el b/spacious-padding.el
index 105a037c5d..c14e4a9ae5 100644
--- a/spacious-padding.el
+++ b/spacious-padding.el
@@ -5,7 +5,7 @@
;; Author: Protesilaos Stavrou <[email protected]>
;; Maintainer: Protesilaos Stavrou <[email protected]>
;; URL: https://github.com/protesilaos/spacious-padding
-;; Version: 0.7.0
+;; Version: 0.8.0
;; Package-Requires: ((emacs "28.1"))
;; Keywords: convenience, focus, writing, presentation
