From b0a42bf5fb4ded45cdd151e691f1ceffdb124a80 Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Sat, 24 Dec 2022 12:05:21 -0700 Subject: add & install a README Signed-off-by: Sean Whitton --- README | 51 ++++++++++++++++++++++++++++++++++++++++++++ debian/changelog | 1 + debian/elpa-mailscripts.docs | 1 + debian/mailscripts.docs | 1 + 4 files changed, 54 insertions(+) create mode 100644 README create mode 100644 debian/elpa-mailscripts.docs create mode 100644 debian/mailscripts.docs diff --git a/README b/README new file mode 100644 index 0000000..d9ecdab --- /dev/null +++ b/README @@ -0,0 +1,51 @@ +mailscripts -- collection of scripts for manipulating e-mail on Unixes +====================================================================== + +This package is a place to collect together, and distribute, small scripts for +manipulating e-mail on Unixes. The idea is that those of us handling our +e-mail using tools like offlineimap, mbsync, notmuch, mu, mairix etc. often +end up writing small helper scripts, and some of the scripts are worth tidying +up, documenting and sharing with others, but they're small enough not to +deserve packages of their own. This is a place for them. + +mailscripts is primarily developed as part of the Debian project. In July +2018 some notmuch-using Debian Developers arrived at the DebCamp preceding +DebConf18, and started discussing useful mail-handling scripts, actual and +envisioned. We decided it would be a good idea to create a package like this. +If you have written a useful mail-handling script, please consider submitting +it to this collection. + +Some highlights: + +* mdmv -- safely move messages between maildirs + +* mbox2maildir -- convert an mbox to a maildir using Python's libraries + +* notmuch-extract-patch -- extract a git patch series from notmuch + +* email-print-mime-structure -- tree view of a message's MIME structure + +* imap-dl -- download messages from an IMAP mailbox to a maildir + +mailscripts.el -- Emacs utilities for handling mail on Unixes +============================================================= + +mailscripts.el is an Emacs Lisp library. It's original purpose was to make it +easy to use scripts shipped in Debian's mailscripts package from within Emacs. +It now also contains additional, thematically-related utilities which don't +invoke any of those scripts. + +Some highlights: + +* notmuch-extract-{thread,message}-patches{,-to-project} + -- extract & apply git patch(es) from Gnus+notmuch or notmuch-show + +* mailscripts-git-format-patch-drafts + -- import patches generated by git-format-patch(1) to Gnus or notmuch drafts + +* mailscripts-git-format-patch-attach + -- compose mail with patches generated by git-format-patch(1) attached + (Git-specific alternative to the built-in vc-prepare-patches) + +* mailscripts-git-format-patch-append + -- append an inline "-- >8 --" patch to an unsent message diff --git a/debian/changelog b/debian/changelog index fc4a04a..8fe34ce 100644 --- a/debian/changelog +++ b/debian/changelog @@ -18,6 +18,7 @@ mailscripts (28-1) UNRELEASED; urgency=medium - 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. + * Add & install a README, to both binary packages. -- Sean Whitton Sun, 18 Dec 2022 10:40:55 -0700 diff --git a/debian/elpa-mailscripts.docs b/debian/elpa-mailscripts.docs new file mode 100644 index 0000000..e845566 --- /dev/null +++ b/debian/elpa-mailscripts.docs @@ -0,0 +1 @@ +README diff --git a/debian/mailscripts.docs b/debian/mailscripts.docs new file mode 100644 index 0000000..e845566 --- /dev/null +++ b/debian/mailscripts.docs @@ -0,0 +1 @@ +README -- cgit v1.2.3