Re: [bug #63957] [mdoc] Synopsis section should not be adjusted (nor hyphenated)

[Alejandro Colomar]

Hi Branden,

On 3/24/23 08:26, G. Branden Robinson wrote:
[...]

> groff 1.22.4 output:
> 
> 
> $ groff -mandoc -Tascii ATTIC/timerdday.mdoc | cat -s
> mdoc warning: Empty input line #34
> 
> Name
>      timerdday -- compute time of launch operation within window
> 
> Synopsis
>      void timerdday(struct-timespec *earliest, struct-timespec *latest,
>      struct-timespec *resolution)

Heh, and you forgot to mention that it doesn't add a trailing semicolon.
Certainly some extra adjustment space is better than the bogus 1.22.4.  :)

> 
> Description
>      Compute the optimal start time for a desired event to occur between
> times
>      earliest and latest to within a granularity of resolution.
> 
> 
> 
> (Yes, "cat -s" is necessary; yes, headers and footers are missing; and yes,
> groff 1.22.4 mdoc really does produce that empty line diagnostic.)
> 
> groff Git HEAD output:
> 
> 
> $ ./build/test-groff -mandoc -Tascii ATTIC/timerdday.mdoc | cat -s

You forgot to remove cat -s in 1.23.0.

> timerdday(3bsd)                      LOCAL                    
> timerdday(3bsd)
> 
> Name
>        timerdday -- compute time of launch operation within window
> 
> Synopsis
>        void
>        timerdday(struct-timespec     *earliest,    struct-timespec   
> *latest,
>            struct-timespec *resolution);

timerdday's API seems a bit bogus: how do you get the result of it?  ;)

> 
> Description
>        Compute the optimal start time for a desired  event  to  occur 
> between
>        times earliest and latest to within a granularity of resolution.
> 
> GNU                              June 6, 1944                 
> timerdday(3bsd)
> 
> 
> So, a big improvement except for the giant gaps in the function prototype.

Yup.

Cheers,
Alex

> 
> Reported by Alex Colomar to
> [https://lists.gnu.org/archive/html/groff/2023-03/msg00079.html the groff
> discussion list].
> 

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

OpenPGP_signature
Description: OpenPGP digital signature