branch: externals/tmr
commit 2ca3ebd2aff2441a09e3c093887a8b2d44593d69
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Rename tmr-confirm to tmr-confirm-single-timer
Add the latter to the manual.
---
README.org | 7 +++++++
tmr.el | 14 ++++++++++----
2 files changed, 17 insertions(+), 4 deletions(-)
diff --git a/README.org b/README.org
index 8045b5eb75..b2e89c7a24 100644
--- a/README.org
+++ b/README.org
@@ -150,6 +150,13 @@ prompting for duration, and (iii) cancelling the original
timer.
The ~tmr-remove-finished~ command deletes all elapsed timers from the
list of timers. This means that they can no longer be cloned.
+#+vindex: tmr-confirm-single-timer
+By default, TMR uses minibuffer completion to pick a timer object in
+operations such as cloning and cancelling. If the user option
+~tmr-confirm-single-timer~ is set nil, TMR will not use completion when
+there is only one timer available: it will perform the specified command
+outright. [ part of {{{development-version}}} ]
+
Timers have hooks associated with their creation, cancellation, and
completion ([[#h:c908f440-da08-462e-be4e-a61fb274ecbc][Hooks]]). TMR can also
integrate with the desktop environment
to send notifications ([[#h:56bbbd6f-5b63-4375-9c86-e1eb231be356][Sound and
desktop notifications]]).
diff --git a/tmr.el b/tmr.el
index 5d028fe471..19863bf345 100644
--- a/tmr.el
+++ b/tmr.el
@@ -67,10 +67,16 @@ If nil, don't play any sound."
file
(const :tag "Off" nil)))
-(defcustom tmr-confirm t
- "Confirm timer operations.
-If set to nil and if there is only a single timer,
-the operation is performed without confirmation."
+(defcustom tmr-confirm-single-timer t
+ "Whether to act on the sole timer outright or with confirmation.
+
+If non-nil (the default), TMR will use the minibuffer to select a
+timer object to operate on, even when there is only one candidate
+available.
+
+If set to nil, TMR will not ask for confirmation when there is
+one timer available: the operatation will be carried out
+outright."
:type 'boolean)
(defcustom tmr-timer-created-functions
