#1136669 manpages-dev: SYNOPSIS for snprintf is wrong and has an extra size parameter

#1136669#5
Date:
2026-05-14 14:31:20 UTC
From:
To:
Dear Maintainer,

manpage for snprintf(3) indicates:

SYNOPSIS
       #include <stdio.h>

       int snprintf(size_t size;
                   char str[restrict size], size_t size,
                   const char *restrict format, ...);
       int vsnprintf(size_t size;
                   char str[restrict size], size_t size,
                   const char *restrict format, va_list ap);

The size parameter is duplicated, for both snprintf() and vsnprintf().
Also note the ";" at the end of the first "size" parameter. This is
nonsense in a C function call.

The correct synopsis should be:

       int snprintf(char str[restrict size], size_t size,
                   const char *restrict format, ...);
       int vsnprintf(char str[restrict size], size_t size,
                   const char *restrict format, va_list ap);

It looks like the generation of /usr/share/man/man3/snprintf.3.gz is
bogus.

It contains:
.SH SYNOPSIS
.nf
.B #include <stdio.h>
.P
.BR "int snprintf(" "size_t size;"
.BI "            char " str "[restrict " size "], size_t " size ,
.BI "            const char *restrict " format ", ...);"
.BR "int vsnprintf(" "size_t size;"
.BI "            char " str "[restrict " size "], size_t " size ,
.BI "            const char *restrict " format ", va_list " ap );
.fi