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

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

1 files changed, 12 insertions, 1 deletions

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)