thunderbird-patch-review

Simple email patch review tool for Thunderbird

commit 9604c1ab4f276d550e2a4719f6d5d8dbe88f86ad
parent d6a0831ec25eca9ca6ca12499a323f6fd57a24f1
Author: Marc <marc@coquand.email>
Date:   Sun, 19 Jul 2026 12:23:59 +0200

README

Diffstat:
M
README.html
 | 
49
++++---------------------------------------------

1 file changed, 4 insertions(+), 45 deletions(-)
diff --git a/README.html b/README.html
@@ -100,51 +100,10 @@
   runs only when the extension is loaded.</p>
 
   <h2>Sourcehut integration</h2>
-  <p>When the series arrives via a sourcehut mailing list (a
-  lists.sr.ht address in the List-Id or recipients), the review tab
-  shows a set status checkbox with the patchset states sourcehut
-  understands: APPROVED, NEEDS_REVISION, REJECTED, PROPOSED,
-  SUPERSEDED, APPLIED. 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.</p>
-
-  <h2>Review workflow</h2>
-  <ol>
-    <li>Select any message of the series -- or the whole thread -- and
-    press Review in the main toolbar.</li>
-    <li>The tab collects the sibling patches from the same folder (same
-    series tag, version, and patch count).</li>
-    <li>Click lines, write comments; Ctrl+Enter saves. "Comment on
-    patch" attaches a general remark instead.</li>
-    <li>Send review: one reply per commented patch, sent immediately
-    (or use the drop-down to preview first).</li>
-    <li>Apply series: git am into the mapped repository, then Open
-    editor on the touched files.</li>
-  </ol>
-
-  <h2>Files</h2>
-  <dl>
-    <dt>extension/</dt>
-    <dd><p>The MailExtension (manifest v2, vanilla ES modules, no
-    build step).</p></dd>
-
-    <dt>extension/api/patchHost/</dt>
-    <dd><p>The privileged part (a WebExtension Experiment): runs
-    git-am(1) and the editor through Thunderbird's Subprocess API and
-    shows the directory chooser with nsIFilePicker. Everything outside
-    this directory runs as ordinary sandboxed WebExtension
-    code.</p></dd>
-
-    <dt>tests/</dt>
-    <dd><p><code>node tests/run.mjs</code> exercises the pure modules
-    (subject parsing, diff parsing, reply formatting) against fixtures
-    generated by git-format-patch(1), and checks the experiment's
-    manifest wiring. Regenerate fixtures with
-    <code>tests/gen-fixtures.sh</code>.</p></dd>
-  </dl>
+  <p>When the series arrives via a sourcehut mailing list, the review
+  tab shows a set status checkbox with the <a href="https://man.sr.ht/lists.sr.ht/#email-controls">patchset states sourcehut
+  understands</a>: APPROVED, NEEDS_REVISION, REJECTED, PROPOSED,
+  SUPERSEDED, APPLIED.</p>
 
   <h2>Caveats</h2>
   <p>Patches arriving as attachments, HTML-only mail, and reviewing