branch: externals/spacious-padding
commit 9d96d301d5bccf192daaf00dba64bca9979dcb5a
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to version 0.3.0
---
CHANGELOG.org | 87 +++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 6 ++--
spacious-padding.el | 2 +-
3 files changed, 91 insertions(+), 4 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index fef4e8f3f7..ae00943a9b 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -13,7 +13,94 @@ the manual: <https://protesilaos.com/emacs/spacious-padding>.
#+toc: headlines 1 insert TOC here, with one headline level
+* Version 0.3.0 on 2023-12-21
+:PROPERTIES:
+:CUSTOM_ID: h:466dd7e0-c314-42a9-b1bc-a499acc5d415
+:END:
+
+** Enjoy the optional subtle mode lines
+:PROPERTIES:
+:CUSTOM_ID: h:57b2702a-3891-4cfc-aa37-e08f1f63290e
+:END:
+
+The new user option ~~spacious-padding-subtle-mode-line~ makes mode
+lines more subtle. It does so by removing the background and adding an
+overline in its stead.
+
+By default, ~spacious-padding-mode~ does not refashion the mode lines
+other than adding to them some extra padding (per ~spacious-padding-widths~).
+The user option ~spacious-padding-subtle-mode-line~ does change the
+mode lines so that instead of a background they only have an overline,
+while preserving whatever padding is in effect.
+
+The value bound to ~spacious-padding-subtle-mode-line~ is either a
+boolean type or a plist. If it is non-nil, use the foreground of the
+underlying mode line face to derive the color of the overline.
+
+If the non-nil value is a plist read the following keys to determine
+the exact style of the overlines.
+
+- ~:mode-line-active~ refers to the active/current mode line.
+
+- ~:mode-line-inactive~ refers to the inactive/non-current mode lines.
+
+Each key accepts either a face or a string representing a color as its
+associated value:
+
+- The face is an unquoted symbol, such as ~success~ or ~shadow~, whose
+ =:foreground= attribute is queried to extract the desired color value.
+
+- The color is a name among those listed in the output of the command
+ ~list-colors-display~ or a hexadecimal RGB value, such as =#123456=.
+
+If the key is missing or its value is not one of the above, fall back
+to reading the foreground of the underlying mode line face to
+determine the color of the overline.
+
+Examples of valid configurations:
+
+#+begin_src emacs-lisp
+;; Use the foreground of the underlying mode line face to determine
+;; the color of the overline (e.g. the inactive mode line has gray
+;; text, so render the overline in the same gray).
+(setq spacious-padding-subtle-mode-line t)
+
+;; Use the foreground of the `error' face (typically a red hue) for
+;; the active mode line's overline. For the inactive mode line, fall
+;; back to the foreground color of the underlying face (as in the case
+;; of the t shown above).
+(setq spacious-padding-subtle-mode-line
+ '(:mode-line-active error))
+
+;; As above, but now use the foreground of the `shadow' face for the
+;; inactive mode line.
+(setq spacious-padding-subtle-mode-line
+ '(:mode-line-active error :mode-line-inactive shadow))
+
+;; Use color values directly.
+(setq spacious-padding-subtle-mode-line
+ '(:mode-line-active "#0000ff" :mode-line-inactive "gray50"))
+#+end_src
+
+** Expanded the documentation
+:PROPERTIES:
+:CUSTOM_ID: h:f205e230-f980-44ac-9ceb-6807f4380480
+:END:
+
+The ~spacious-padding~ package now comes with an Info manual. When
+looking at the source code, this is done in the =README.org= file,
+which the GNU ELPA machinery automatically converts to Info. A change
+log is also provided.
+
+Their respective web links are these:
+
+- <https://protesilaos.com/emacs/spacious-padding>
+- <https://protesilaos.com/emacs/spacious-padding-changelog>
+
* Version 0.2.0 on 2023-11-24
+:PROPERTIES:
+:CUSTOM_ID: h:375d5280-9ee8-4a5d-9eca-e5b3967a3bdb
+:END:
[ I provide screenshots in a recent publication:
<https://protesilaos.com/codelog/2023-11-15-spacious-padding-extra-ui-dev/> ]
diff --git a/README.org b/README.org
index fcb635deca..bf156fe35a 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.2.0
-#+macro: release-date 2023-11-24
-#+macro: development-version 0.3.0-dev
+#+macro: stable-version 0.3.0
+#+macro: release-date 2023-12-21
+#+macro: development-version 0.4.0-dev
#+export_file_name: spacious-padding.texi
#+texinfo_filename: spacious-padding.info
#+texinfo_dir_category: Emacs misc features
diff --git a/spacious-padding.el b/spacious-padding.el
index dfe0c0f276..78a7f123aa 100644
--- a/spacious-padding.el
+++ b/spacious-padding.el
@@ -6,7 +6,7 @@
;; Maintainer: Protesilaos Stavrou General Issues
<~protesilaos/general-iss...@lists.sr.ht>
;; URL: https://git.sr.ht/~protesilaos/spacious-padding
;; Mailing-List: https://lists.sr.ht/~protesilaos/general-issues
-;; Version: 0.2.2
+;; Version: 0.3.0
;; Package-Requires: ((emacs "28.1"))
;; Keywords: convenience, focus, writing, presentation
