gzr.im — pyonji

From f906fa87e95371a5f412ab0a44502cdc652e80be Mon Sep 17 00:00:00 2001 From: Robert Günzler Date: Wed, 8 Jan 2025 11:52:11 +0100 Subject: add pyonji page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Robert Günzler --- site/index.html | 1 + site/pyonji.html | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ src/inc/index.htm | 1 + src/inc/pyonji.htm | 25 ++++++++++++++++++++ src/inc/pyonji.md | 26 +++++++++++++++++++++ 5 files changed, 120 insertions(+) create mode 100644 site/pyonji.html create mode 100644 src/inc/pyonji.htm create mode 100644 src/inc/pyonji.md diff --git a/site/index.html b/site/index.html index 835b9b6..cffa268 100644 --- a/site/index.html +++ b/site/index.html @@ -42,6 +42,7 @@

diff --git a/site/pyonji.html b/site/pyonji.html new file mode 100644 index 0000000..fbd6661 --- /dev/null +++ b/site/pyonji.html @@ -0,0 +1,67 @@ + + + + + + + + + +gzr.im — pyonji + + +

+ +

+ + + +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:

ensure th to +address is set (or pass --to)
+git config --local sendemail.to
use origin/master or HEAD~n for the +--base option, this determines what is included in the +patch series
when sending to a public-inbox style list, ensure the subject +prefix is set
+git config --local format.subjectprefix
when writing the cover letter, note that the first paragraph is +parsed as the subject of the patch series, see –cover-from-description

+ + + diff --git a/src/inc/index.htm b/src/inc/index.htm index 470c232..8c35e24 100644 --- a/src/inc/index.htm +++ b/src/inc/index.htm @@ -12,6 +12,7 @@

diff --git a/src/inc/pyonji.htm b/src/inc/pyonji.htm new file mode 100644 index 0000000..8bfb2fa --- /dev/null +++ b/src/inc/pyonji.htm @@ -0,0 +1,25 @@ + + +2025-01-08 + +

ensure th to +address is set (or pass --to)
+git config --local sendemail.to
use origin/master or HEAD~n for the +--base option, this determines what is included in the +patch series
when sending to a public-inbox style list, ensure the subject +prefix is set
+git config --local format.subjectprefix
when writing the cover letter, note that the first paragraph is +parsed as the subject of the patch series, see –cover-from-description

diff --git a/src/inc/pyonji.md b/src/inc/pyonji.md new file mode 100644 index 0000000..8f55983 --- /dev/null +++ b/src/inc/pyonji.md @@ -0,0 +1,26 @@ +--- +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 -- cgit 1.4.1