]> 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:23:15 +0000 (15:23 +0200)
commitb71a51189d3e1a2f515d93c0444916293bd5221f
tree1180f99373af21409809f6160508c8dd52ade78a
parent946006d37cfc66c162877fc678405525a50f20df
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