summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKyle Meyer <kyle@kyleam.com>2020-09-19 12:47:37 -0400
committerKyle Meyer <kyle@kyleam.com>2020-09-19 12:47:37 -0400
commit7a98f40e99a1c06ef76e6c92694023c1d8309103 (patch)
treebeabc3eb1f68a5d4bb342ee9c659cbec8d0945df
parent96d1dc07fd2854a11598a89eb7cf7b53bfc3b14c (diff)
downloadpiem-7a98f40e99a1c06ef76e6c92694023c1d8309103.tar.gz
Fill in missing library commentaries
These aren't too useful (and I don't want to duplicate what is or at least should be in the manual), but they're better than nothing.
-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: