Re: man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens

[Alejandro Colomar]

Hi Branden,

On 3/23/23 22:22, G. Branden Robinson wrote:
> Hi Brian,
> 
> At 2023-03-16T19:39:27-0600, Brian Inglis wrote:
>> Output of man pages with lengthy synopses from grohtml do not disable
>> adjustment and hyphenation as for tty, breaking long options between
>> the hyphens and anywhere else available.
> [snip]
> 
> I cannot reproduce this problem with groff Git HEAD, viewing the
> generated HTML with Firefox and lynx(1).[1]  My conjecture is that my
> heavy refactoring of groff man(7) since 1.22.4 fixed your issue.

I saw yesterday something that might have to do with this.  Check the
timespecsub(3bsd) man (actually mdoc(7)) page, and in the SYNOPSYS
you'll find some weird filled function prototypes.  I tried adding
hyphens to them, to see if it would break there, and it breaks, even
on the terminal!

Here's a small reproducer of this issue (which might have to do with
the one reported by Brian, or might be a different one):

$ cat timespecsub.3 
.Dd June 7, 2010
.Dt timeradd 3bsd
.Os
.Sh NAME
.Nm timespecsub
.Nd operations on time structure
.Sh SYNOPSIS
.Ft void
.Fn timespecsub "struct-timespec *a" \
"struct-timespec *b" "struct-timespec *res"
alx@asus5775:~/tmp$ man ./timespecsub.3 |cat
timeradd(3bsd)                       LOCAL                      timeradd(3bsd)

NAME
       timespecsub — operations on time structure

SYNOPSIS
       void
       timespecsub(struct‐timespec    *a,    struct‐timespec    *b,    struct‐
           timespec *res);

GNU                              June 7, 2010                   timeradd(3bsd)


With \- it doesn't break there.

Cheers,
Alex

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

OpenPGP_signature
Description: OpenPGP digital signature