branch: externals/cursory
commit 568310b13dfeda471fa23c6aa9b88c2a410aed01
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to version 0.3.0
---
CHANGELOG.org | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 10 +++-------
cursory.el | 2 +-
3 files changed, 54 insertions(+), 8 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index 47584935f2..9ea8a70d76 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,6 +9,56 @@ project's main git repository:
<https://sr.ht/~protesilaos/cursory>.
The newest release is at the top. For further details, please consult
the manual: <https://protesilaos.com/emacs/cursory>.
+* Version 0.3.0 on 2022-09-04
+
++ Implemented a mechanism to read fallback values for the presets
+ specified in the user option ~cursory-presets~. In practical terms,
+ there can now be a =t= preset which holds the default values. Any
+ other named preset overrides the =t=, so it only needs to specify the
+ properties that differ from the defaults. Sample using the original
+ value:
+
+ #+begin_src emacs-lisp
+ (setq cursory-presets
+ '((box
+ :blink-cursor-interval 0.8)
+ (box-no-blink
+ :blink-cursor-mode -1)
+ (bar
+ :cursor-type (bar . 2)
+ :blink-cursor-interval 0.5)
+ (underscore
+ :cursor-type (hbar . 3)
+ :blink-cursor-blinks 50)
+ (t ; the default values
+ :cursor-type box
+ :cursor-in-non-selected-windows hollow
+ :blink-cursor-mode 1
+ :blink-cursor-blinks 10
+ :blink-cursor-interval 0.2
+ :blink-cursor-delay 0.2)))
+ #+end_src
+
++ Expanded the available properties of the user option ~cursory-presets~
+ to accept a value for the =:blink-cursor-mode= key (as seen in the
+ above code block). It is either =1= or =-1= and is passed to the
+ function ~blink-cursor-mode~. The former value enables the mode, the
+ latter disables it. This lets ~cursory-presets~ set the
+ ~blink-cursor-mode~ per stylistic variant.
+
++ Refined the default value of the minibuffer prompt that is used by the
+ command ~cursory-set-preset~. The default value now is the previous
+ element in the history, if it exists. This makes it easier to toggle
+ between the last two choices (select the default value simply by
+ pressing =RET= without any further input).
+
++ Specified a =:package-version= for all user options. The user is
+ informed in relevant Help buffers about the last version that
+ introduced or iterated on the variable.
+
++ The =cursory= group now references the Info manual that ships with the
+ GNU ELPA package. A link is shown in Custom UI buffers.
+
* Version 0.2.0 on 2022-07-01
This is a stability release that introduces minor tweaks while
diff --git a/README.org b/README.org
index 74951800ff..742eab0a7c 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 2022-07-01
-#+macro: development-version 0.3.0-dev
+#+macro: stable-version 0.3.0
+#+macro: release-date 2022-09-04
+#+macro: development-version 0.4.0-dev
#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
#+macro: space @@texinfo:@: @@
#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@@ -100,14 +100,10 @@ built-in variables: ~cursor-type~,
~cursor-in-non-selected-windows~,
The value each property accepts is the same as the variable it
references.
-[ The property =:blink-cursor-mode= is part of {{{development-version}}} ]
-
A property of =:blink-cursor-mode= is also available. It is a numeric
value of either =1= or =-1= and is given to the function
~blink-cursor-mode~ (=1= is to enable, =-1= is to disable the mode).
-[ The fallback =t= value for ~cursory-presets~ is part of
{{{development-version}}} ]
-
A preset whose car is =t= is treated as the default option. This makes
it possible to specify multiple presets without duplicating their
properties. The other presets beside =t= act as overrides of the
diff --git a/cursory.el b/cursory.el
index f08b05530a..5fb08902a5 100644
--- a/cursory.el
+++ b/cursory.el
@@ -6,7 +6,7 @@
;; Maintainer: Cursory Development <~protesilaos/curs...@lists.sr.ht>
;; URL: https://git.sr.ht/~protesilaos/cursory
;; Mailing-List: https://lists.sr.ht/~protesilaos/cursory
-;; Version: 0.2.1
+;; Version: 0.3.0
;; Package-Requires: ((emacs "27.1"))
;; Keywords: convenience, cursor
