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

Collin Funk
2025-11-27T06:55:03Z

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

Alejandro Colomar <alx@kernel.org> writes:

> On Tue, Nov 25, 2025 at 08:05:24PM -0600, G. Branden Robinson wrote:
>> Hi Collin,
>>
>> 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")'.

>> > -.BI _ PID _GNU_nonoption_argv_flags_
>> > +.IR _ PID _GNU_nonoption_argv_flags_
>
> For now, I'll keep the current style, which is consistent in the
> project.

It still looks strange to me. But I guess I will survive. :)

Thank you both for the explanations.

Collin

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