[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: man page .SY/.YS synopsis .OP HTML output breaks long options betwee
From: |
Alejandro Colomar |
Subject: |
Re: man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens |
Date: |
Thu, 23 Mar 2023 23:53:18 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.8.0 |
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
- man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens, Brian Inglis, 2023/03/16
- Re: man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens, G. Branden Robinson, 2023/03/23
- Re: man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens, G. Branden Robinson, 2023/03/23
- Re: man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens,
Alejandro Colomar <=
- adjustment and hyphenation in mdoc(7) pages, G. Branden Robinson, 2023/03/24
- Re: adjustment and hyphenation in mdoc(7) pages, G. Branden Robinson, 2023/03/24
- Re: adjustment and hyphenation in mdoc(7) pages, G. Branden Robinson, 2023/03/24
- Re: adjustment and hyphenation in mdoc(7) pages, Alejandro Colomar, 2023/03/24
- Re: adjustment and hyphenation in mdoc(7) pages, G. Branden Robinson, 2023/03/24
- Re: adjustment and hyphenation in mdoc(7) pages, Dave Kemper, 2023/03/24
- using the `hw` request in man pages (was: adjustment and hyphenation in mdoc(7) pages), G. Branden Robinson, 2023/03/25
- Re: using the `hw` request in man pages (was: adjustment and hyphenation in mdoc(7) pages), Alejandro Colomar, 2023/03/25
- Re: using the `hw` request in man pages (was: adjustment and hyphenation in mdoc(7) pages), G. Branden Robinson, 2023/03/26