---
date: 2025-01-08
---

[pyonji] is a useful tool to send patches to mailing lists, to contribute to
projects hosted on [sr.ht] for example. It is a friendly TUI alternative to
using `git-send-email` directly, but there are still some essentials to note:

1. ensure th [to address] is set (or pass `--to`)   
   `git config --local sendemail.to`

2. use `origin/master` or `HEAD~n` for the `--base` option, this determines what 
   is included in the patch series

3. when sending to a public-inbox style list, ensure the [subject prefix] is set  
   `git config --local format.subjectprefix`

4. when writing the cover letter, note that the first paragraph is parsed as the
   subject of the patch series, see [--cover-from-description]


[pyonji]: https://git.sr.ht/~emersion/pyonji
[sr.ht]: https://sr.ht/projects
[to address]: https://git-scm.com/docs/git-config/2.22.1#Documentation/git-config.txt-formatsubjectPrefix
[subject prefix]: https://git-scm.com/docs/git-config/2.22.1#Documentation/git-config.txt-formatsubjectPrefix
[--cover-from-description]: https://git-scm.com/docs/git-format-patch#Documentation/git-format-patch.txt---cover-from-descriptionltmodegt