aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--piem-b4.el4
-rw-r--r--piem-elfeed.el4
-rw-r--r--piem-eww.el4
-rw-r--r--piem-gnus.el4
-rw-r--r--piem-notmuch.el5
-rw-r--r--piem.el10
6 files changed, 27 insertions, 4 deletions
diff --git a/piem-b4.el b/piem-b4.el
index 596e563..75b2344 100644
--- a/piem-b4.el
+++ b/piem-b4.el
@@ -21,7 +21,11 @@
;;; Commentary:
+;; This library provides a Transient [1] interface to b4 [2]. It is
+;; documented in the piem manual.
;;
+;; [1] https://magit.vc/manual/transient/
+;; [2] https://git.kernel.org/pub/scm/utils/b4/b4.git
;;; Code:
diff --git a/piem-elfeed.el b/piem-elfeed.el
index add7547..c0cc5a3 100644
--- a/piem-elfeed.el
+++ b/piem-elfeed.el
@@ -21,7 +21,9 @@
;;; Commentary:
-;;
+;; This library provides a minor mode, `piem-elfeed-mode', that
+;; modifies `piem' variables to teach functions like `piem-inbox' how
+;; to extract information from Elfeed buffers.
;;; Code:
diff --git a/piem-eww.el b/piem-eww.el
index 849a3b5..69b6000 100644
--- a/piem-eww.el
+++ b/piem-eww.el
@@ -21,7 +21,9 @@
;;; Commentary:
-;;
+;; This library provides a minor mode, `piem-eww-mode', that modifies
+;; `piem' variables to teach functions like `piem-inbox' how to
+;; extract information from EWW buffers.
;;; Code:
diff --git a/piem-gnus.el b/piem-gnus.el
index 172468f..4afa747 100644
--- a/piem-gnus.el
+++ b/piem-gnus.el
@@ -21,7 +21,9 @@
;;; Commentary:
-;;
+;; This library provides a minor mode, `piem-gnus-mode', that modifies
+;; `piem' variables to teach functions like `piem-inbox' and
+;; `piem-am-ready-mbox' how to extract information from Gnus buffers.
;;; Code:
diff --git a/piem-notmuch.el b/piem-notmuch.el
index 7941736..cd3153a 100644
--- a/piem-notmuch.el
+++ b/piem-notmuch.el
@@ -21,7 +21,10 @@
;;; Commentary:
-;;
+;; This library provides a minor mode, `piem-notmuch-mode', that
+;; modifies `piem' variables to teach functions like `piem-inbox' and
+;; `piem-am-ready-mbox' how to extract information from Notmuch
+;; buffers.
;;; Code:
diff --git a/piem.el b/piem.el
index 9dce914..6ec757d 100644
--- a/piem.el
+++ b/piem.el
@@ -23,7 +23,17 @@
;;; Commentary:
+;; This library provides functionality for working with public-inbox
+;; archives [1] within Emacs (e.g., applying a patch series to the
+;; associated Git repository or downloading an mbox for the thread and
+;; injecting it into a local Maildir directory). The user option
+;; `piem-inboxes' defines a set of public-inbox archives. For most
+;; the functions here to do something useful, the current buffer needs
+;; to be linked to an inbox in that list, which requires enabling the
+;; minor mode provided by at least one integration library (such as
+;; `piem-gnus', `piem-eww', or `piem-notmuch').
;;
+;; [1] https://public-inbox.org/README
;;; Code: