Re: adjustment and hyphenation in mdoc(7) pages

[Alejandro Colomar]

Hi Branden,

On 3/24/23 06:55, G. Branden Robinson wrote:
[...]

> Perhaps instead:
> 
>   At the beginning of a word, it suppresses any hyphenation breaks
>   within _except_ those specified with \%.
> 
> Here is a fixed version of the reproducer:
> 
> .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"
> 
> \% is desperately underused, despite being as portable as anything is in
> *roff.  Learn it, live it, love it!

While I could even buy you that \% might not be a good default for
man(7)'s .B and .I, you can't buy that \% is not _always_ wanted in
mdoc(7)'s .Fn.  I can't imagine why you would want to break a word
in a function prototype.  The same as .MR implies \%, I think .Fn
also should.

> 
> Regards,
> Branden
> 
> [1] The reader is invited to look this one up.  Learn to fire up a V7
>     Unix environment under SIMH as I have and party like it's 1979!

Heh, I guess I'll have to try...

Cheers,
Alex


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

OpenPGP_signature
Description: OpenPGP digital signature