Hi Bruno,

On 2026-02-22T15:10:03+0100, Bruno Haible wrote:
> Alejandro Colomar wrote:
> >      .B #include <string.h>
> >      .P
> >     -.BI char\~*strnul(const\~char\~* s );
> >     +.BI QChar\~*strnul(QChar\~* s );
> >      .fi
> 
> Ouch. This is not understandable. Why should a user learn about what 'QChar'
> is??
> 
> It's basically like a C++ template with 2 instantiations. Just list them
> explicitly; this will be much clearer.
> 
> It's common that the SYNOPSIS section has several lines. For example,
> man1/locale.1 has 4 separate lines.

Hmmm; sounds reasonable.  I'll do that.


Cheers,
Alex

-- 
<https://www.alejandro-colomar.es>

Attachment: signature.asc
Description: PGP signature

Reply via email to