branch: externals/standard-themes
commit 56551daac67f904b9975dc5bc027e77ba243937c
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to version 1.1.0
---
CHANGELOG.org | 83 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 11 +++-----
standard-themes.el | 2 +-
3 files changed, 88 insertions(+), 8 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
new file mode 100644
index 0000000000..09fe1c9a8c
--- /dev/null
+++ b/CHANGELOG.org
@@ -0,0 +1,83 @@
+#+title: Change log of the Standard Themes
+#+author: Protesilaos Stavrou
+#+email: i...@protesilaos.com
+#+options: ':nil toc:nil num:nil author:nil email:nil
+
+This document contains the release notes for each tagged commit on the
+project's main git repository:
<https://git.sr.ht/~protesilaos/standard-themes>.
+
+The newest release is at the top. For further details, please consult
+the manual: <https://protesilaos.com/emacs/standard-themes>.
+
+* Version 1.1.0 on 2022-12-06
+:PROPERTIES:
+:CUSTOM_ID: h:f7a5799c-279c-4dfb-96ae-3eba58ee582e
+:END:
+
+** The ~standard-themes-headings~ now covers the Org agenda
+:PROPERTIES:
+:CUSTOM_ID: h:d7fa8d0c-b49c-447a-a24c-4dc18c6d755b
+:END:
+
+The user option ~standard-themes-headings~ lets the user control the
+height, weight, and use of proportionately spaced fonts
+(~variable-pitch~) on a per-heading basis. Different combinations are
+possible, as explained in the option's doc string on the corresponding
+entry in the manual.
+
+I have now made it possible to specify the =agenda-date= and
+=agenda-structure= keys. Both pertain to the Org agenda. The former
+applies to date headings, while the latter styles the headings of each
+"block" of content. In a generic agenda buffer, that block heading is
+the first line which reads =Week-agenda (W49):= or something like
+that, though we find such headings in more places as well.
+
+Here is a sample with various stylistic variants per heading:
+
+#+begin_src emacs-lisp
+(setq standard-themes-headings ; read the manual's entry or the doc string
+ '((0 . (variable-pitch light 1.9))
+ (1 . (variable-pitch light 1.8))
+ (2 . (semilight 1.7))
+ (3 . (semilight 1.6))
+ (4 . (1.5)) ; absence of weight means "regular"
+ (5 . (1.4))
+ (6 . (bold 1.3))
+ (7 . (bold 1.2))
+ (agenda-date . (semilight 1.5))
+ (agenda-structure . (variable-pitch light 1.9))
+ (t . (variable-pitch 1.1))))
+#+end_src
+
+Note that Org re-uses heading levels past 8. This means that level 9
+will look the same as level 1. This is not the theme's doing. Check
+the user options ~org-level-faces~, ~org-n-level-faces~ for ways to
+change this.
+
+** =M-x theme-choose-variant= works as expected
+:PROPERTIES:
+:CUSTOM_ID: h:9c95de58-9d0c-44dd-bc24-63ce7691806e
+:END:
+
+Users of Emacs 29 have access to the command ~theme-choose-variant~:
+it toggles between two themes of the same family. If the family
+has more members, it uses minibuffer completion instead.
+
+I registered the appropriate theme properties to make this work as
+intended. However, it is still possible to use the command
+~standard-themes-toggle~.
+
+** Stylistic refinements
+:PROPERTIES:
+:CUSTOM_ID: h:33e6d85e-42cc-4a30-87d5-47d9b81cc769
+:END:
+
++ Simplified the Magit blame faces to avoid exaggerations.
++ Revised the colours of day headings in the =M-x calendar= buffer.
+ Weekends stand out, as is the case with physical calendars and many
+ established apps.
++ Made the ~edmacro-label~ face stand out in its context. Otherwise
+ it was difficult to spot. This is for Emacs 29 and applies to
+ headings in the keyboard macro editing buffer (e.g. with =C-x C-k
+ C-e= (~kmacro-edit-macro-repeat~)).
++ Added support for the =powerline= package.
diff --git a/README.org b/README.org
index a5bb66dd4a..43c455e148 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 1.0.0
-#+macro: release-date 2022-11-30
-#+macro: development-version 1.1.0-dev
+#+macro: stable-version 1.1.0
+#+macro: release-date 2022-12-06
+#+macro: development-version 1.2.0-dev
#+export_file_name: standard-themes.texi
#+texinfo_filename: standard-themes.info
#+texinfo_dir_category: Emacs misc features
@@ -385,9 +385,6 @@ In user configuration files the form may look like this:
:CUSTOM_ID: h:8540fd7a-7633-4eb9-af4b-4f160568f79a
:END:
-[ Expanded as part of {{{development-version}}}. It now accepts the
- =agenda-date= and =agenda-structure= keys for the Org agenda headings. ]
-
#+vindex: standard-themes-headings
The user option ~standard-themes-headings~ provides support for individual
heading styles for regular heading levels 0 through 8, as well as the
@@ -1048,7 +1045,7 @@ everything most users need.
- outline-minor-faces
- package (=M-x list-packages=)
- perspective
-- powerline [ Part of {{{development-version}}} ]
+- powerline
- pulsar
- pulse
- rainbow-delimiters
diff --git a/standard-themes.el b/standard-themes.el
index ed7bec50b6..ebbb6da728 100644
--- a/standard-themes.el
+++ b/standard-themes.el
@@ -6,7 +6,7 @@
;; Maintainer: Standard-Themes Development
<~protesilaos/standard-the...@lists.sr.ht>
;; URL: https://git.sr.ht/~protesilaos/standard-themes
;; Mailing-List: https://lists.sr.ht/~protesilaos/standard-themes
-;; Version: 1.0.2
+;; Version: 1.1.0
;; Package-Requires: ((emacs "27.1"))
;; Keywords: faces, theme, accessibility
