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 [off-list ref]' \
    --cc='linux-man@vger.kernel.org' --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: