]> git.ipfire.org Git - thirdparty/glibc.git/commit
manual/stdio: Clarify putc and putwc
authorArjun Shankar <arjun@redhat.com>
Mon, 29 Jul 2024 12:30:59 +0000 (14:30 +0200)
committerArjun Shankar <arjun@redhat.com>
Mon, 29 Jul 2024 13:00:50 +0000 (15:00 +0200)
commit65fbcfe58991194301a7e4fb9c53ab936573e711
treebce96c3c197f0898991ca8ccb7e9d1422d796d67
parent5d2a931a8167a288374c3a38dc10fe0492ab5ffe
manual/stdio: Clarify putc and putwc

The manual entry for `putc' described what "most systems" do instead of
describing the glibc implementation and its guarantees.  This commit
fixes that by warning that putc may be implemented as a macro that
double-evaluates `stream', and removing the performance claim.

Even though the current `putc' implementation does not double-evaluate
`stream', offering this obscure guarantee as an extension to what
POSIX allows does not seem very useful.

The entry for `putwc' is also edited to bring it in line with `putc'.
Reviewed-by: Florian Weimer <fweimer@redhat.com>
(cherry picked from commit 10de4a47ef3f481592e3c62eb07bcda23e9fde4d)
manual/stdio.texi