[elpa] externals/tmr 79a57fce51 4/4: Release version 0.3.0

[ELPA Syncer]

branch: externals/tmr
commit 79a57fce5139f764eee1a7f1414e3075d4e1549b
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Release version 0.3.0
---
 CHANGELOG.org       | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.org          |  6 ++---
 tmr-notification.el |  2 +-
 tmr-sound.el        |  2 +-
 tmr-tabulated.el    |  2 +-
 tmr.el              |  2 +-
 6 files changed, 71 insertions(+), 7 deletions(-)

diff --git a/CHANGELOG.org b/CHANGELOG.org
new file mode 100644
index 0000000000..7a4451ad15
--- /dev/null
+++ b/CHANGELOG.org
@@ -0,0 +1,64 @@
+* Version 0.3.0 on 2022-05-17
+
+The gist of TMR's May Release is that TMR is Maintained Rigorously---but
+enough with The Mostly Recursive acronyms!
+
++ This is the first version for which we produce a change log.  The
+  short story of previous releases: I (Protesilaos) was using and
+  developing TMR (pronounced as "timer" or "T-M-R") as part of my
+  personal setup for more than a year until I eventually contributed it
+  to GNU ELPA.
+
++ What was once =tmr.el= is now split up into purpose-specific files:
+  =tmr.el= (core functionality), =tmr-tabulated.el= (grid view),
+  =tmr-sound.el= (audible notifications), and =tmr-notification.el=
+  (desktop notifications).
+
++ The ~tmr-with-description~ command creates a new timer while always
+  asking for a description.  Whereas the standard ~tmr~ command prompts
+  for a description only when invoked with a prefix argument.
+
++ The ~tmr-clone~ command copies the duration and optional description
+  of an existing timer object into a new one.  The operation is
+  performed without further questions, except if a prefix argument is
+  supplied: in that case the command will prompt for a duration and, if
+  the original timer had a description, for one as well.  The default
+  values of these prompts are those of the original timer.
+
++ The ~tmr-remove-finished~ deletes all elapsed timers.  This means that
+  they are removed from the list of available timers and, thus, cannot
+  be cloned.
+
++ The ~tmr-timer-created-functions~, ~tmr-timer-completed-functions~,
+  and ~tmr-timer-cancelled-functions~ are hooks which can be used to
+  control what happens once a timer is (i) created, (ii) elapses, or
+  (iii) is cancelled.
+
++ Elapsed and running timers are displayed in a grid view with the
+  command ~tmr-tabulated-view~.  The buffer looks like this:
+
+  #+begin_example
+  Start      End        Finished?  Description
+  09:22:43   09:32:43   ✔         Prepare tea
+  09:17:14   09:37:14              Boil water
+  09:07:03   09:57:03              Bake bread
+  #+end_example
+
++ In that grid view, it is possible to create a new timer, or operate on
+  the one at point to cancel, clone, redescribe, and reschedule it.
+
++ Thanks to Christian Tietze for implementing changes to how desktop
+  notifications are handled.  The overall effect should still be the
+  same for existing users, though the implementation has been redesigned.
+
++ Thanks to Damien Cassou who is now is my co-author due to multiple
+  contributions for =tmr.el=, the addition of the grid view, and the
+  splitting of TMR into numerous files.  Please consult the Git commit
+  log for the details.  (I still am the maintainer.)
+
++ Christian and Damien have assigned copyright to the Free Software
+  Foundation.  It is required for all packages distributed via GNU ELPA.
+
+The manual documents the technicalities and provides a sample
+configuration.  Either evaluate the form =(info "(tmr) Top")= if you
+have the package installed or visit https://protesilaos.com/emacs/tmr.
diff --git a/README.org b/README.org
index c967429c9c..41e9cab9cb 100644
--- a/README.org
+++ b/README.org
@@ -5,9 +5,9 @@
 #+options: ':t toc:nil author:t email:t num:t
 #+startup: content
 
-#+macro: stable-version 0.2.0
-#+macro: release-date 2022-04-21
-#+macro: development-version 0.3.0-dev
+#+macro: stable-version 0.3.0
+#+macro: release-date 2022-05-17
+#+macro: development-version 0.4.0-dev
 #+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
 #+macro: space @@texinfo:@: @@
 #+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
diff --git a/tmr-notification.el b/tmr-notification.el
index 1764007f52..88753fae27 100644
--- a/tmr-notification.el
+++ b/tmr-notification.el
@@ -7,7 +7,7 @@
 ;; Maintainer: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://git.sr.ht/~protesilaos/tmr
 ;; Mailing list: https://lists.sr.ht/~protesilaos/tmr
-;; Version: 0.2.3
+;; Version: 0.3.0
 ;; Package-Requires: ((emacs "27.1"))
 
 ;; This file is NOT part of GNU Emacs.
diff --git a/tmr-sound.el b/tmr-sound.el
index 53c99559b9..540b833d58 100644
--- a/tmr-sound.el
+++ b/tmr-sound.el
@@ -7,7 +7,7 @@
 ;; Maintainer: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://git.sr.ht/~protesilaos/tmr
 ;; Mailing list: https://lists.sr.ht/~protesilaos/tmr
-;; Version: 0.2.3
+;; Version: 0.3.0
 ;; Package-Requires: ((emacs "27.1"))
 
 ;; This file is NOT part of GNU Emacs.
diff --git a/tmr-tabulated.el b/tmr-tabulated.el
index 1fa2b5180c..c6080a449f 100644
--- a/tmr-tabulated.el
+++ b/tmr-tabulated.el
@@ -7,7 +7,7 @@
 ;; Maintainer: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://git.sr.ht/~protesilaos/tmr
 ;; Mailing list: https://lists.sr.ht/~protesilaos/tmr
-;; Version: 0.2.3
+;; Version: 0.3.0
 ;; Package-Requires: ((emacs "27.1"))
 
 ;; This file is NOT part of GNU Emacs.
diff --git a/tmr.el b/tmr.el
index a7031b0d9b..676f3a3613 100644
--- a/tmr.el
+++ b/tmr.el
@@ -7,7 +7,7 @@
 ;; Maintainer: Protesilaos Stavrou <info@protesilaos.com>
 ;; URL: https://git.sr.ht/~protesilaos/tmr
 ;; Mailing list: https://lists.sr.ht/~protesilaos/tmr
-;; Version: 0.2.3
+;; Version: 0.3.0
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: convenience, timer