about summary refs log tree commit diff
path: root/src/inc/pyonji.htm
blob: f9ac64dc05439fb2abfed7cfd37240b4cdbddfa4 (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
<!-- Generated file, you may edit and discard src/inc/pyonji.md :) -->
<span class="date">
2025-01-08
</span>
<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>
<ol type="1">
<li><p>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></p></li>
<li><p>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</p></li>
<li><p>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></p></li>
<li><p>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></p></li>
</ol>