* [Bug 216461] New: Misleading synposis in printf(3) for vsnprintf(3)
@ 2022-09-08 1:42 bugzilla-daemon
0 siblings, 0 replies; only message in thread
From: bugzilla-daemon @ 2022-09-08 1:42 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=216461
Bug ID: 216461
Summary: Misleading synposis in printf(3) for vsnprintf(3)
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages@kernel-bugs.osdl.org
Reporter: sam@gentoo.org
Regression: No
Hi!
The printf(3) page says:
```
SYNOPSIS
#include <stdio.h>
int printf(const char *restrict format, ...);
[...]
#include <stdarg.h>
int vprintf(const char *restrict format, va_list ap);
[...]
int vsnprintf(char *restrict str, size_t size,
const char *restrict format, va_list ap);
```
It might just be me, but the gap between the two blocks of functions made me
think that only <stdarg.h> was needed for those latter functions, even though
it's needed for va_list.
Would it be appropriate to add a second #include <stdio.h> above #include
<stdarg.h> to resolve the ambiguity?
Thanks!
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2022-09-08 1:43 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-09-08 1:42 [Bug 216461] New: Misleading synposis in printf(3) for vsnprintf(3) bugzilla-daemon
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).