summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKyle Meyer <kyle@kyleam.com>2021-02-07 02:57:38 -0500
committerKyle Meyer <kyle@kyleam.com>2021-02-07 12:38:51 -0500
commitf4975ba183c54ec364827380ee70c5ccc426e06f (patch)
tree4d891eacfdc24b38d4268364d06c07406c6435c2
parentcd24891a7752c4ea7f509337ba2df31334e9b83a (diff)
downloadpiem-f4975ba183c54ec364827380ee70c5ccc426e06f.tar.gz
manual: Add section on "copy public-inbox link" functionality
Cc: Xinglu Chen <public@yoctocell.xyz> Message-Id: <20210207075738.8752-6-kyle@kyleam.com>
-rw-r--r--piem.texi35
1 files changed, 33 insertions, 2 deletions
diff --git a/piem.texi b/piem.texi
index 070adf4..e3019c7 100644
--- a/piem.texi
+++ b/piem.texi
@@ -48,7 +48,7 @@ This manual is for piem version @value{VERSION}.
* Overview::
* Getting started::
* Applying patches::
-* Injecting messages into a Maildir directory::
+* Miscellaneous functionality::
* Contributing::
Appendices
@@ -383,8 +383,11 @@ other things, functionality for applying patch series, including
b4-inspired patch extraction.
+@node Miscellaneous functionality
+@chapter Miscellaneous functionality
+
@node Injecting messages into a Maildir directory
-@chapter Injecting messages into a Maildir directory
+@section Injecting messages into a Maildir directory
@cindex Maildir
public-inbox allows you to follow lists through several mechanisms
@@ -441,6 +444,34 @@ non-nil if a message ID is known and should be skipped. For Notmuch,
#'piem-notmuch-known-mid-p)
@end lisp
+@node Copying public-inbox URLs
+@section Copying public-inbox URLs
+
+@findex piem-copy-mid-url
+When referring to a message from a public-inbox archive, a common format
+to use is a URL that points to a specific archive and ends with
+@code{/$INBOX/$MESSAGE_ID}, e.g.,
+@url{https://public-inbox.org/meta/20190108015420.GA28903@@dcvr}.
+Calling @code{piem-copy-mid-url} (available in the @code{piem-dispatch}
+transient) constructs such a URL, using the message ID and inbox
+asscociated with the current buffer, and then copies the URL to the kill
+ring. When a prefix agument is given, @code{browse-url} is called after
+copying the URL.
+
+@vindex piem-browse-url-browser-function
+Note that EWW works nicely with public-inbox's HTTP interface. If you'd
+prefer it to be invoked even though it's not your default browser (as
+configured by @code{browse-url-browser-function}), you can set
+@code{piem-browse-url-browser-function} to @code{eww-browse-url}.
+
+@findex piem-notmuch-mode
+@findex piem-notmuch-show-get-public-inbox-link
+For notmuch.el users, there's an additional entry point for copying
+public-inbox URLs: enabling @code{piem-notmuch-mode} adds a ``piem''
+candidate to archives offered by
+@code{notmuch-show-stash-mlarchive-link} and
+@code{notmuch-show-stash-mlarchive-link-and-go}.
+
@node Contributing
@chapter Contributing