Re: [PATCH v9] regex.3: Desoupify regerror() description

[Alejandro Colomar <alx.manpages@gmail.com>]

[-- Attachment #1.1: Type: text/plain, Size: 3251 bytes --]



On 4/21/23 14:26, Alejandro Colomar wrote:
> On 4/21/23 14:03, наб wrote:
>> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
> 
> Aaand patch applied!  I believe I've got all, right?

Feel free to add yourself to the copyright.  You clearly deserve it ;)

> 
> Cheers,
> Alex
> 
>> ---
>> Range-diff against v8:
>> 1:  4479e1572 ! 1:  38109fcc6 regex.3: Desoupify regerror() description
>>     @@ man3/regex.3: .SS Error reporting
>>      +.IR preg .
>>      +.PP
>>      +If
>>     -+.I errbuf_size
>>     -+is
>>     -+.BR 0 ,
>>     -+the size of the required buffer is returned.
>>     -+Otherwise, up to
>>       .I errbuf_size
>>      -are nonzero,
>>      -.I errbuf
>>      -is filled in with the first
>>      -.I "errbuf_size \- 1"
>>      -characters of the error message and a terminating null byte (\[aq]\e0\[aq]).
>>     ++isn't 0, up to
>>     ++.I errbuf_size
>>      +bytes are copied to
>>      +.IR errbuf ;
>>      +the error string is always null-terminated, and truncated to fit.
>>       .SS Freeing
>>       .BR regfree ()
>>       deinitializes the pattern buffer at
>>     +@@ man3/regex.3: .SH RETURN VALUE
>>     + returns zero for a successful match or
>>     + .B REG_NOMATCH
>>     + for failure.
>>     ++.PP
>>     ++.BR regerror ()
>>     ++returns the size of the buffer required to hold the string.
>>     + .SH ERRORS
>>     + The following errors can be returned by
>>     + .BR regcomp ():
>>
>>  man3/regex.3 | 36 ++++++++++++++++--------------------
>>  1 file changed, 16 insertions(+), 20 deletions(-)
>>
>> diff --git a/man3/regex.3 b/man3/regex.3
>> index d91acc19d..efca582d7 100644
>> --- a/man3/regex.3
>> +++ b/man3/regex.3
>> @@ -210,27 +210,20 @@ .SS Error reporting
>>  .BR regexec ()
>>  into error message strings.
>>  .PP
>> -.BR regerror ()
>> -is passed the error code,
>> -.IR errcode ,
>> -the pattern buffer,
>> -.IR preg ,
>> -a pointer to a character string buffer,
>> -.IR errbuf ,
>> -and the size of the string buffer,
>> -.IR errbuf_size .
>> -It returns the size of the
>> -.I errbuf
>> -required to contain the null-terminated error message string.
>> -If both
>> -.I errbuf
>> -and
>> +If
>> +.I preg
>> +isn't a null pointer,
>> +.I errcode
>> +must be the latest error returned from an operation on
>> +.IR preg .
>> +.PP
>> +If
>>  .I errbuf_size
>> -are nonzero,
>> -.I errbuf
>> -is filled in with the first
>> -.I "errbuf_size \- 1"
>> -characters of the error message and a terminating null byte (\[aq]\e0\[aq]).
>> +isn't 0, up to
>> +.I errbuf_size
>> +bytes are copied to
>> +.IR errbuf ;
>> +the error string is always null-terminated, and truncated to fit.
>>  .SS Freeing
>>  .BR regfree ()
>>  deinitializes the pattern buffer at
>> @@ -247,6 +240,9 @@ .SH RETURN VALUE
>>  returns zero for a successful match or
>>  .B REG_NOMATCH
>>  for failure.
>> +.PP
>> +.BR regerror ()
>> +returns the size of the buffer required to hold the string.
>>  .SH ERRORS
>>  The following errors can be returned by
>>  .BR regcomp ():
> 

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

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]