mailscripts.el: rewrite short description and add a brief commentary

Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>

3 files changed, 24 insertions, 4 deletions

diff --git a/debian/changelog b/debian/changelog
index 223c3c8..76624f3 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,7 +3,10 @@ mailscripts (28-1) UNRELEASED; urgency=medium
   * mailscripts.el:
     - new commands: mailscripts-git-format-patch-{attach,drafts}
     - new DWIM wrapper command: mailscripts-prepare-patch
+    - rewrite short description and add a brief commentary
     - fix usage of cl-case in an internal function.
+  * debian/control: update Description: for elpa-mailscripts.
+    Use the new short description and commentary from mailscripts.el.
 
  -- Sean Whitton <spwhitton@spwhitton.name>  Sun, 18 Dec 2022 10:40:55 -0700
 
diff --git a/debian/control b/debian/control
index 5753610..62e29b9 100644
--- a/debian/control
+++ b/debian/control
@@ -33,9 +33,15 @@ Recommends:
 Enhances:
  emacs,
  emacs25,
-Description: Emacs functions for accessing tools in the mailscripts package
- This package adds to Emacs functions to access tools in the
- mailscripts package from Emacs.
+Description: Emacs utilities for handling mail on Unixes
+ The original purpose of this package was to make it easy to use the small
+ mail-handling utilities shipped in the 'mailscripts' package from within
+ Emacs.  It now also contains some additional, thematically-related utilities
+ which don't invoke any of those scripts.
+ .
+ Entry points you might like to look at if you're new to this package:
+ mailscripts-prepare-patch, notmuch-slurp-debbug,
+ notmuch-extract-{thread,message}-patches{,-to-project}.
 
 Package: mailscripts
 Depends:
diff --git a/mailscripts.el b/mailscripts.el
index f3e1e53..790793b 100644
--- a/mailscripts.el
+++ b/mailscripts.el
@@ -1,4 +1,4 @@
-;;; mailscripts.el --- functions to access tools in the mailscripts package  -*- lexical-binding: t; -*-
+;;; mailscripts.el --- utilities for handling mail on Unixes  -*- lexical-binding: t; -*-
 
 ;; Author: Sean Whitton <spwhitton@spwhitton.name>
 ;; Version: 27
@@ -19,6 +19,17 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
+;; The original purpose of this package was to make it easy to use the small
+;; mail-handling utilities shipped in Debian's 'mailscripts' package from
+;; within Emacs.  It now also contains some additional, thematically-related
+;; utilities which don't invoke any of those scripts.
+;;
+;; Entry points you might like to look at if you're new to this package:
+;; mailscripts-prepare-patch, notmuch-slurp-debbug,
+;; notmuch-extract-{thread,message}-patches{,-to-project}.
+
 ;;; Code:
 
 (require 'cl-lib)