blob: 209d81cd07075342891cf5154699cdc3113e2373 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
<!-- Generated file, you may edit and discard pyonji.md :) -->
<span class="date">
2025-01-08
</span>
<h1 id="sending-patches-with-pyonji">Sending patches with Pyonji</h1>
<p><a href="https://git.sr.ht/~emersion/pyonji"
target="_blank">pyonji</a> is a useful tool to send patches to mailing
lists, to contribute to projects hosted on <a
href="https://sr.ht/projects" target="_blank">sr.ht</a> for example. It
is a friendly TUI alternative to using <code>git-send-email</code>
directly, but there are still some essentials to note:</p>
<ul class="task-list">
<li><p><label><input type="checkbox" />ensure th <a
href="https://git-scm.com/docs/git-config/2.22.1#Documentation/git-config.txt-formatsubjectPrefix"
target="_blank">to address</a> is set (or pass <code>--to</code>)<br />
<code>git config --local sendemail.to</code></label></p></li>
<li><p><label><input type="checkbox" />use <code>origin/master</code> or
<code>HEAD~n</code> for the <code>--base</code> option, this determines
what is included in the patch series</label></p></li>
<li><p><label><input type="checkbox" />when sending to a public-inbox
style list, ensure the <a
href="https://git-scm.com/docs/git-config/2.22.1#Documentation/git-config.txt-formatsubjectPrefix"
target="_blank">subject prefix</a> is set<br />
<code>git config --local format.subjectprefix</code></label></p></li>
<li><p><label><input type="checkbox" />when writing the cover letter,
note that the first paragraph is parsed as the subject of the patch
series, see <a
href="https://git-scm.com/docs/git-format-patch#Documentation/git-format-patch.txt---cover-from-descriptionltmodegt"
target="_blank">–cover-from-description</a></label></p></li>
</ul>
<p>I keep a branch with some convenience patches on top of upstream,
that make working with it easier for me: <a
href="https://git.sr.ht/~robertgzr/pyonji/log/devel" class="uri"
target="_blank">https://git.sr.ht/~robertgzr/pyonji/log/devel</a></p>
|
