Merge pull request #177 from kickingvegas/merge-development-to-main-2…

…0240827_213617

Merge development to main 20240827_213617

README.org

@@ -23,6 +23,11 @@ Menus are a user interface (UI) affordance that offer users discoverability and
 * Asks
 As Casual Calc is new, we are looking for early adopters! Your [[https://github.com/kickingvegas/casual-calc/issues][feedback]] is welcome as it will likely impact Casual's evolution, particularly with regards to UI.
 
+* Requirements
+Casual Calc requires usage of
+- Emacs ≥ 29.1
+- Casual Lib ≥ 1.1.0
+
 * Install
 Casual Calc is available on [[https://melpa.org/#/casual-calc][MELPA]].
 
@@ -49,7 +54,11 @@ If you use ~use-package~, here is the recipe for installing it.
     :after (calc))
 #+end_src
 
-Casual Calc requires Emacs 29.1+.
+** A Note on Package Dependencies
+Casual Calc requires Casual Lib which in turn requires a recent installation of Transient 0.6.0+ from either [[https://elpa.gnu.org/packages/transient.html][ELPA]] or [[https://melpa.org/#/transient][MELPA]]. As an older version of Transient is built-in to the Emacs release, the package manager ~package.el~ will /not/ update this package unless the customizable variable ~package-install-upgrade-built-in~ is set to ~t~. Set this variable and proceed with installing Casual Calc. Alternately invoking ~package-install~ with a prefix (~C-u~) will temporarily coerce the update of the built-in package. (example: ~C-u M-x package-install~ ~casual-calc~)
+
+As Transient is closely tied to Magit, installing the latest version of Magit (via [[https://elpa.nongnu.org/nongnu/magit.html][non-GNU ELPA]] or [[https://melpa.org/#/magit][MELPA]]) before installing Casual Calc can also pick up the latest version of Transient.
+
 
 * Usage
 1. Invoke ~M-x calc~ to launch Calc.
@@ -114,22 +123,11 @@ If you enjoy using Casual Calc, consider making a modest financial contribution
 
 [[https://www.buymeacoffee.com/kickingvegas][file:docs/images/default-yellow.png]]
 
-* See Also
-Casual Calc is part of a suite of user interfaces for different Emacs packages.
 
-To get all current and future Casual user interfaces, please install [[https://github.com/kickingvegas/casual-suite][Casual Suite]] from [[https://melpa.org/#/casual-suite][MELPA]].
-
-User Interfaces currently supported by Casual are listed below:
-
-- [[https://github.com/kickingvegas/casual-isearch][Casual I-Search]] - a Transient menu for I-Search.
-- [[https://github.com/kickingvegas/casual-dired][Casual Dired]] - a Transient user interface for the Dired file manager.
-- [[https://github.com/kickingvegas/casual-info][Casual Info]] - a Transient user interface for Info.  
-- [[https://github.com/kickingvegas/casual-bookmarks][Casual Bookmarks]] - a Transient user interface for Bookmarks.
-- [[https://github.com/kickingvegas/casual-ibuffer][Casual IBuffer]] - a Transient user interface for IBuffer.
-- [[https://github.com/kickingvegas/casual-re-builder][Casual RE-Builder]] - a Transient user interface for RE-Builder.  
-- [[https://github.com/kickingvegas/casual-avy][Casual Avy]] - a Transient user interface for Avy.
+* See Also
+Casual Calc is part of a suite of user interfaces for different Emacs packages called [[https://github.com/kickingvegas/casual-suite][Casual Suite]].
 
-Users who prefer finer grained control over package installation can install each user interface above individually.
+Different interfaces include those for I-Search, Dired, Info, Bookmarks, RE-Builder, IBuffer, and others. Learn more about them today!
 
 
 * Acknowledgments

lisp/casual-calc-version.el

@@ -22,7 +22,7 @@
 
 ;;; Code:
 
-(defconst casual-calc-version "1.11.2"
+(defconst casual-calc-version "1.11.3"
   "Casual Version.")
 
 (defun casual-calc-version ()

lisp/casual-calc.el

@@ -5,7 +5,7 @@
 ;; Author: Charles Choi <[email protected]>
 ;; URL: https://github.com/kickingvegas/casual-calc
 ;; Keywords: tools
-;; Version: 1.11.2
+;; Version: 1.11.3
 ;; Package-Requires: ((emacs "29.1") (casual-lib "1.1.0"))
 
 ;; This program is free software; you can redistribute it and/or modify
@@ -43,6 +43,12 @@
 ;;          ("C-o" . casual-calc-tmenu))
 ;;   :after (calc))
 
+;; NOTE: This package requires `casual-lib' which in turn requires an update of
+;; the built-in package `transient' ≥ 0.6.0. Please customize the variable
+;; `package-install-upgrade-built-in' to t to allow for `transient' to be
+;; updated. For further details, consult the INSTALL section of this package's
+;; README.
+
 ;;; Code:
 
 (require 'calc)