Hi Alex,
At 2024-07-27T22:30:54+0200, Alejandro Colomar wrote:
> Do these changes only apply to syscalls(2)?
Yes.
> No other page has anything like that?
Yes, there are other pages with something like that.
man/man3/stdio.3
man/man7/namespaces.7
man/man7/signal-safety.7
man/man7/signal.7
man/man7/suffixes.7
I have a script that pattern-matches macro-style man page cross
references and font-style cross references.[1]
Here are the counts for man-pages master:
$ wc -l macro.MR stragglers.MR
16193 macro.MR
892 stragglers.MR
17085 total
After this patch set:
16696 macro.MR
389 stragglers.MR
17085 total
This series is not a total solution, but it takes a bite out of the
problem. Further, I think I've finally got a reliable stack of sed
scripts and a procedure that shows my work and is easy to use, so other
tables with font-based cross references in them should migrate with
greater ease.
> BTW, I prefer if the patches from a set are replies to the cover
> letter. :)
That's difficult for me because I generate the series _first_.[2] At
that time I do not know what the MUA will construct for a Message-ID for
item 0 in the series. Do you have a suggestion?
Regards,
Branden
[1] $ cat find-MR-migrators.sh
> macro.MR
> stragglers.MR
# Deliberately non-migrating: tzfile.5, zdump.8, zic.8
git grep -n '^\.[BI]R \(\\%\)*\([.@_[:alnum:]\\-]\+\) (\([1-9a-z]\+\))' >> macro.MR
# 1 false positive: _syscall.2
git grep -n '^\.R[BI] [^ ]\+ [A-Za-z0-9_]\+.*(.*[1-9].*)' >> macro.MR
git grep -n '\\f[BI]\(\\%\)*\([.@_[:alnum:]\\-]\+\)\\fP(\([1-9a-z]\+\))' >> stragglers.MR
[2] $ cat ~/bin/man-pages-format-patch
#!/bin/sh
mbox="$HOME/Mail/Drafts/messages"
if [ $# -lt 1 ]
then
echo "usage: $0 BEGIN..END" >&2
exit 2
fi
git format-patch --to='Alejandro Colomar <alx@xxxxxxxxxx>' \
--cc='linux-man@xxxxxxxxxxxxxxx' --stdout "$@" \
>> $HOME/Mail/Drafts/messages
if [ $? -ne 0 ]
then
echo "$0: problem" >&2
exit 1
fi
git log --oneline "$@"
cat <<EOF
Patches generated in $mbox.
Will now launch neomutt; use '<ESC>e' to send.
Delete the draft(s) afterward with 'd'.
EOF
read -p 'Ready? ' junk
neomutt -f "$mbox"
# vim:set ai et sw=4 ts=4 tw=80:
Attachment:
signature.asc
Description: PGP signature
