Re: [PATCH v8 3/5] regex.3: Finalise move of reg*.3type

[Alejandro Colomar]

On 4/21/23 13:48, Alejandro Colomar wrote:
> Hi наб and Branden,
> 
> On 4/21/23 12:33, Alejandro Colomar wrote:
> [...]
> 
>>> diff --git a/man3/regex.3 b/man3/regex.3
>>> index f6465d484..46fd3adef 100644
>>> --- a/man3/regex.3
>>> +++ b/man3/regex.3
>>> @@ -15,7 +15,7 @@ .SH LIBRARY
>>>  Standard C library
>>>  .RI ( libc ", " \-lc )
>>>  .SH SYNOPSIS
>>> -.nf
>>> +.EX
>>
>> I've been thinking about this, but am not yet fully convinced.  I'll
>> propose you the two alternatives, and let you decide what looks best.
>>
>> (a)  Use .nf/.fi for the function prototypes, and .EX/.EE for the
>>      types.
>>
>> (b)  .EX/.EE for everything, as you did.
>>
>> Please have a look at the PDF versions (you can run
>> `pdfman ./man3/regex.3` after you `source ./scripts/bash_aliases`).
>>
>> If you're going to use it often, I suggest the following in
>> ~/.bash_aliases:
>>
>> if [ -f ~/src/linux/man-pages/man-pages/main/scripts/bash_aliases ]; then
>>      . ~/src/linux/man-pages/man-pages/main/scripts/bash_aliases;
>> fi;
>>
>>
> [...]
> 
>>
>>
>>>  .B #include <regex.h>
>>>  .PP
>>>  .BI "int regcomp(regex_t *restrict " preg ", const char *restrict " regex ,
>>> @@ -43,7 +43,7 @@ .SH SYNOPSIS
>>>  .B } regmatch_t;
>>>  .PP
>>>  .BR typedef " /* ... */  " regoff_t;
>>> -.fi
>>> +.EE
>>>  .SH DESCRIPTION
>>>  .SS Compilation
>>>  .BR regcomp ()
> 
> Which one looks better to you?  I've attached two PDF files (which
> linux-man@ will reject, but I CCd groff@) so that you can compare.

D'oh!  I sent wrong PDFs.  Here they are.

> 
> Any other alternatives?
> 
> Cheers,
> Alex
> 

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

regex.3.uacCBf
Description: Adobe PDF document

regex.3.6HycxK
Description: Adobe PDF document

OpenPGP_signature
Description: OpenPGP digital signature