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.
> > 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.
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.
Attachment:
signature.asc
Description: PGP signature
