Re: [PATCH 2/4] man/man7/sched.7: Update the documentation references

["G. Branden Robinson" <g.branden.robinson@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2390 bytes --]

Hi Sebastian,

At 2025-09-08T16:34:11+0200, Sebastian Andrzej Siewior wrote:
> On 2025-09-08 09:29:15 [-0500], G. Branden Robinson wrote:
> > Okay.  What terminal type are you using?  xterm, gnome-terminal,
> > Linux VT, etc.?
> 
> lxterminal 0.4.1-1
> 
> > Also, try this:
> > 
> > $ MANROFFOPT=-rU0 man $your_sched_page
> 
> So this renders is as
> 
> | The Linux kernel documentation for the scheduler ⟨https://docs.kernel.org/scheduler⟩
> 
> which would be okay. So the problem is more on my end then?

Yes and no.  You've done nothing wrong, but your system configuration is
manifesting a problem.  It sounds like lxterminal doesn't support OSC 8
escape sequences[1], but handles unsupported ECMA-48 escape sequences
correctly, ignoring them instead of making the terminal screen a mess.

This same problem was raised by Helge Kreutzmann last month.  I expect
we're starting to see it more frequently because groff 1.23.0 (released
July 2023) finally made it into a Debian stable release, and there are
even more Debian users than I suspected.

https://lore.kernel.org/linux-man/20250825230420.2dl2kkchtmkwjge7@illithid/

There are a number of workarounds while the community sorts out an
end-to-end solution that will involve cooperation between grotty(1) [on
my plate], ncurses/terminfo, and, ideally, terminal emulator
maintainers.  (Strictly speaking, the last group doesn't _need_ to be
involved; anybody could submit patches to ncurses's terminfo database to
advertise relevant terminal types' support for a so-far-unnamed
capability representing OSC 8 support.)  Beyond those mentioned at the
top of the foregoing mail, here's another approach you could put in your
(more or less POSIX-conforming) shell's startup file.

case "$TERM" in
xterm*) MANROFFOPT=-rU0 ;;
*) ;;
esac
export MANROFFOPT

(I don't see a terminal type entry for "lxterminal" in ncurses's
"terminfo.src" file; this isn't a problem as long as lxterminal _very
faithfully_ emulates xterm.  If it doesn't, an lxterminal developer or
power user should probably submit a type description.  This is true
irrespective of OSC 8 support.)

I'm sorry for the difficulty; advancing the terminal emulation state of
the art takes the work of multiple pairs of hands.

Regards,
Branden

[1] https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]