thunderbird-patch-review
Easy-to-use patch review interface for Thunderbird
Contribute: ~marcc/thunderbird-review-plugin@lists.sr.ht
git clone git://mccd.space/thunderbird-patch-review
| Log | Files | Refs | README | LICENSE |
commit 3d9a1dfa357025f749fb06649ae62622c7db211b parent 1df01a0be4b4c9db7731b7190b57bd22d197ad57 Author: Marc <marc@coquand.email> Date: Sat, 18 Jul 2026 17:29:35 +0200 Add introductory post to README Diffstat:
| M | README | | | 51 | +++++++++++++++++++++++++++------------------------ |
| M | patch-review.1 | | | 5 | +++++ |
2 files changed, 32 insertions(+), 24 deletions(-)
diff --git a/README b/README
@@ -11,7 +11,7 @@ SYNOPSIS
DESCRIPTION
patch-review brings a review interface to git-by-email workflows
(git-send-email(1) style). When the selected messages (or thread) look
- like a patch -- a [PATCH] subject tag or a unified diff in the body --
+ like a patch — a [PATCH] subject tag or a unified diff in the body —
the Review button in the main toolbar becomes active. It opens a
dedicated review tab that shows the whole series: cover letter, per-
patch commit messages, and every file and hunk rendered as a colored
@@ -31,8 +31,8 @@ DESCRIPTION
nothing is lost. Apply series runs git am --3way on the raw patch
messages in the configured repository. On conflict git am --abort is
run and its output reported, leaving the repository untouched. Its
- drop-down offers Modify and apply -- apply, then open the touched files
- in your editor -- and Download patchset -- save the raw series as one
+ drop-down offers Modify and apply — apply, then open the touched files
+ in your editor — and Download patchset — save the raw series as one
mbox file, ready for git am.
INSTALLATION
@@ -45,7 +45,7 @@ INSTALLATION
has an external dependency.
1. Extension (temporary, for development)
- In Thunderbird open Tools -> Developer Tools -> Debug Add-ons,
+ In Thunderbird open Tools → Developer Tools → Debug Add-ons,
choose Load Temporary Add-on..., and pick
extension/manifest.json. The add-on is dropped on restart, so
use step 2 for a permanent install.
@@ -84,11 +84,11 @@ CONFIGURATION
PERMISSIONS
The extension requests the fewest permissions it needs; none are
- granted to remote content. What each is for:
+ granted to remote content.
messagesRead
- Reads the selected message and its sibling patches in the
- same folder (subject, author, body) to build the review.
+ Reads the selected message and its sibling patches in the same
+ folder (subject, author, body) to build the review.
accountsRead
Resolves the default identity of the account that owns the
@@ -96,24 +96,23 @@ PERMISSIONS
storage
Persists draft comments (keyed by Message-ID) across restarts,
- and the editor command, apply strategy, repo mappings, and
- the last applied repository path.
+ plus the editor command, apply strategy, repo mappings, and the
+ last applied repository path.
- compose, compose.send
- Opens reply-to-all compose windows from Send review, and
- sends them in Send now mode. Without compose.send the review
- can only be previewed in compose, never sent.
+ compose, (compose.send)
+ Opens reply-to-all compose windows from Send review and sends
+ them in Send now mode. Without compose.send the review can only
+ be previewed in compose, never sent.
downloads
Writes the Download patchset .mbox to disk.
- tabs
- Opens the review tab and removes it after a successful send.
+ tabs Opens the review tab and removes it after a successful send.
- The privileged Apply / Browse... / Open editor code does not
- use a Mozilla permission: it is a WebExtension Experiment
- (experiment_apis.patchHost) shipped inside the XPI and runs
- only when the extension is loaded.
+ The privileged Apply, Browse... , and Open editor code does not use a
+ Mozilla permission: it is a WebExtension Experiment
+ (experiment_apis.patchHost) shipped inside the XPI and runs only when
+ the extension is loaded.
SOURCEHUT INTEGRATION
When the series arrives via a sourcehut mailing list (a lists.sr.ht
@@ -123,12 +122,12 @@ SOURCEHUT INTEGRATION
When enabled, the first reply of the review carries an
X-Sourcehut-Patchset-Update header with the chosen status, which
sourcehut applies to the patchset. A status can also be sent without
- any line comments -- Send review then sends a single, empty reply to
- the cover letter (or first patch) carrying just the header.
+ any line comments — Send review then sends a single, empty reply to the
+ cover letter (or first patch) carrying just the header.
REVIEW WORKFLOW
- 1. Select any message of the series -- or the whole
- thread -- and press Review in the main toolbar.
+ 1. Select any message of the series — or the whole
+ thread — and press Review in the main toolbar.
2. The tab collects the sibling patches from the same folder
(same series tag, version, and patch count).
3. Click lines, write comments; Ctrl+Enter saves.
@@ -159,8 +158,12 @@ CAVEATS
git worktree preview are not supported yet. Series collection searches
the folder of the opened message only.
+SEE ALSO
+ The introductory post can be found at
+ <https://mccd.space/posts/26-07-18/3-patch-review-tool-for-thunderbird>
+
CONTRIBUTING
- Disclaimer: this plugin was vibe coded -- written by an AI agent under
+ Disclaimer: this plugin was vibe coded — written by an AI agent under
human direction.
Contributions and bug reports go to the mailing list:
diff --git a/patch-review.1 b/patch-review.1
@@ -225,6 +225,11 @@ Regenerate fixtures with
Patches arriving as attachments, HTML-only mail, and reviewing from a git
worktree preview are not supported yet.
Series collection searches the folder of the opened message only.
+.SH SEE ALSO
+.PP
+The introductory post can be found at
+.MT https://mccd.space/posts/26-07-18/3-patch-review-tool-for-thunderbird
+.ME
.SH CONTRIBUTING
Disclaimer: this plugin was vibe coded \(em written by an AI agent under
human direction.