Re: [PATCH] man/man3/getopt.3: Restore angle brackets.

[Alejandro Colomar <alx@kernel.org>]

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

Hi Branden,

On Fri, Dec 19, 2025 at 10:25:03AM -0600, G. Branden Robinson wrote:
> Hi Alex,
> 
> At 2025-11-27T13:12:26+0100, Alejandro Colomar wrote:
> > On Wed, Nov 26, 2025 at 10:54:59PM -0800, Collin Funk wrote:
> > > Alejandro Colomar <alx@kernel.org> writes:
> > > > On Tue, Nov 25, 2025 at 08:05:24PM -0600, G. Branden Robinson wrote:
> > > >> At 2025-11-25T17:15:39-0800, Collin Funk wrote:
> > > >> > While looking at 'man -S 3 getopt' the underlining under PID
> > > >> > looked strange to me.
> > > >
> > > > The underlining under 'PID' means that it's a variable part.  We
> > > > use that syntax in many pages.  This is documented in
> > > > groff_man(3), as Branden said.
> > > >
> > > > However, you might have also noticed some dotted underline that
> > > > extends until the end of the line.  I think that's a bug somewhere
> > > > --might be in the terminal emulator, because I see it in
> > > > xfce4-terminal(1) but not in xterm(1)--.
> > > 
> > > I was using Gnome terminal and Emacs '(man "getopt.3")'.
> > 
> > Hmmm, I can reproduce the dotted underline in gnome-terminal(1) too.
> > I don't know where's the bug.  It might be in both.  Branden, can you
> > have a look at it?  I guess you'll know better than me about these
> > issues.
> 
> The dotted underline is how gnome-terminal(1) marks a hyperlink.  The
> man page source explicitly formats this text as a hyperlink.
> 
> MP> .P
> MP> Very old versions of glibc were affected by a
> MP> .UR https://\:sourceware.org/\:git/\:?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05
> MP> .BI _ PID _GNU_nonoption_argv_flags_
> MP> environment variable
> MP> .UE .

I know this; however, for some reason I hadn't realized that we had a
hyperlink here.  My bad; a bug in my brain, it seems.  Thanks!  :)

> 
> I observe a few cases of failure to protect literals from hyphenation in
> this page, include the aforementioned literal.
> 
>        Very  old  versions  of  glibc  were  affected   by   a   _PID_GNU_nonop‐
>        tion_argv_flags_ environment variable.
> 
> I'll prepare a patch.

Thanks!


Have a lovely day!
Alex

> Regards,
> Branden



-- 
<https://www.alejandro-colomar.es>

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