Hi Branden, Any advances with git-send-email(1)? I've added some more documentation for it: commit 60660c87e8f75edd9f9d93666315f313dd3743db (HEAD -> contrib, alx/contrib) Author: Alejandro Colomar <alx@xxxxxxxxxx> Date: Sat Aug 31 23:38:20 2024 +0200 CONTRIBUTING.d/git: Recommend format.thread=true This generates patch sets as threads, with a Message-ID pre-set for the first mail. Cc: "G. Branden Robinson" <branden@xxxxxxxxxx> Signed-off-by: Alejandro Colomar <alx@xxxxxxxxxx> diff --git a/CONTRIBUTING.d/git b/CONTRIBUTING.d/git index 4f1003a61..0029e7ee2 100644 --- a/CONTRIBUTING.d/git +++ b/CONTRIBUTING.d/git @@ -1,38 +1,42 @@ Name Git - instructions for configuring git(1) Description git-diff(1), gitattributes(5) To produce useful hunk contexts in manual pages, we need to hack git(1)'s idea of a function name, and also to tell git what is a manual page. $ git config --global diff.man.xfuncname '^\.S[SHsh] .*$'; $ echo '*.[0-9]* diff=man' >>~/.config/git/attributes; git-format-patch(1) Send patches to the right addresses. $ git config --local format.to 'Alejandro Colomar <alx@xxxxxxxxxx>'; $ git config --local format.cc '<linux-man@xxxxxxxxxxxxxxx>'; + Generate patch sets as a thread. + + $ git config --global format.thread true; + git-send-email(1) If mutt(1) or neomutt(1) are configured in the system, git-send-email(1) can be configured to use any of them as a driver. Recent versions of neomutt(1) can enable crypto with -C. $ git config --global \ sendemail.sendmailcmd 'neomutt -C -H - && true'; or $ git config --global sendemail.sendmailcmd 'mutt -H - && true'; See also git-config(1) git-diff(1) git-format-patch(1) git-send-email(1) gitattributes(5) mutt(1) neomutt(1) CONTRIBUTING.d/* On Sat, Aug 31, 2024 at 04:23:21PM GMT, G. Branden Robinson wrote: > Hi Alex, > > At 2024-08-31T22:43:04+0200, Alejandro Colomar wrote: > > On Sat, Aug 31, 2024 at 01:20:27PM GMT, G. Branden Robinson wrote: > [...] > > I guess \# doesn't appear in your actual script. What I usually do to > > avoid problems with git(1) is to indent everything. > > Reasonable in some circumstances, but I had a second problem--one of the > sed commands was very long, and I didn't to make an overlong line even > worse with indentation... > > > > \# blocks to themselves use text blocks, and convert them to use man(7) > > > \# macros instead of troff(1) font selection escape sequences (which > > > \# cannot be done outside a text block). > > > /^\.\\"/b > > > /^\\fB[^\\]*\\fP([0-9][a-z]*).*T{/s/\\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\(.*\)/T{\ > > ...thus. I prefer long lines than scripts that need to be fixed before running. > > > > diff --git a/man/man2/syscalls.2 b/man/man2/syscalls.2 > > > index c259901e7..89c4e7f10 100644 > > > --- a/man/man2/syscalls.2 > > > +++ b/man/man2/syscalls.2 > > > @@ -139,8 +139,8 @@ .SS System call list > > > .\" instructive about x86 specifics. > > > .\" > > > .TS > > > -Lb Lb Lb > > > -L2 L Lx. > > > +Lb Lb Lb > > > +Lw(26n)2 L Lx. > > > > Ughh, I've applied it. > > I expected you wouldn't like it, and, yes, it's ugly and not > future-proof,[1] but: > > 1. It was really important to me to demonstrate that the large changes > I was making diff-wise didn't regress the state of the rendered > page. Hence "dump-page.sh" and doing the cmp(1) comparison. > > When this page was converted to text blocks, the leftmost column > shrank by (IIRC) 2 character cells. I didn't want a corruption of > text to hide amid that. > > 2. The table format can be further changed after the (intrusive) `MR` > migration; either restoring the previous or using the `x` column > modifier in multiple columns, which I know GNU tbl supports and I > think mandoc(1) does too. > > 3. Indecision about what to do put a lag of a month in following up on > my previous "migration preparation" attempt,[2][3] so I decided to > just cut through the difficulty by applying the principle in the > first point. Sounds reasonable. I've applied patches 1, 2, and 3. I haven't applied 4 and 5. Please resend, as smaller patches if possible. Cheers, Alex > > Regards, > Branden > > [1] People who pray might want to pray that Linux system call names > don't get _even longer_. > > [2] https://lore.kernel.org/linux-man/20240727210927.d3iiwpbvkvtp2mzs@illithid/ > > [3] ...although subscribers to the bug-groff and/or groff-commit lists > can make some pretty shrewd guesses about what accounts for _most_ > of the delay. -- <https://www.alejandro-colomar.es/>
Attachment:
signature.asc
Description: PGP signature