2a30b8f4b2
Upstream commit: dcaf51b41e259387602774829c45222d0507f90a - elf: Change ldconfig auxcache magic number (bug 32231) - Make tst-strtod-underflow type-generic - Add crt1-2.0.o for glibc 2.0 compatibility tests - Add tests of more strtod special cases - Add more tests of strtod end pointer - Make tst-strtod2 and tst-strtod5 type-generic - powerpc64le: Build new strtod tests with long double ABI flags (bug 32145) - Do not set errno for overflowing NaN payload in strtod/nan (bug 32045) - Improve NaN payload testing - Make __strtod_internal tests type-generic - Fix strtod subnormal rounding (bug 30220) - More thoroughly test underflow / errno in tst-strtod-round - Test errno setting on strtod overflow in tst-strtod-round - Add tests of fread - stdio-common: Add new test for fdopen - libio: Attempt wide backup free only for non-legacy code - debug: Fix read error handling in pcprofiledump - elf: Fix tst-dlopen-tlsreinit1.out test dependency - elf: Avoid re-initializing already allocated TLS in dlopen (bug 31717) - elf: Clarify and invert second argument of _dl_allocate_tls_init - elf: Support recursive use of dynamic TLS in interposed malloc - nptl: Use <support/check.h> facilities in tst-setuid3 - posix: Use <support/check.h> facilities in tst-truncate and tst-truncate64 - ungetc: Fix backup buffer leak on program exit [BZ #27821] - ungetc: Fix uninitialized read when putting into unused streams [BZ #27821] - Make tst-ungetc use libsupport - stdio-common: Add test for vfscanf with matches longer than INT_MAX [BZ #27650] - support: Add FAIL test failure helper - string: strerror, strsignal cannot use buffer after dlmopen (bug 32026) - Define __libc_initial for the static libc - x86: Fix bug in strchrnul-evex512 [BZ #32078] - Adjust check-local-headers test for libaudit 4.0 - x32/cet: Support shadow stack during startup for Linux 6.10 - x86-64: Remove sysdeps/x86_64/x32/dl-machine.h - support: Add options list terminator to the test driver - manual/stdio: Further clarify putc, putwc, getc, and getwc - Fix name space violation in fortify wrappers (bug 32052) - resolv: Fix tst-resolv-short-response for older GCC (bug 32042) - Add mremap tests - mremap: Update manual entry - linux: Update the mremap C implementation [BZ #31968] - Enhanced test coverage for strncmp, wcsncmp - Enhance test coverage for strnlen, wcsnlen Resolves: RHEL-57776 Resolves: RHEL-57777 Resolves: RHEL-61392
74 lines
3.6 KiB
Diff
74 lines
3.6 KiB
Diff
commit 6eebc92cb290bed20dfb5726a88bafa02f6a2ba7
|
|
Author: Arjun Shankar <arjun@redhat.com>
|
|
Date: Tue Jul 30 11:37:57 2024 +0200
|
|
|
|
manual/stdio: Further clarify putc, putwc, getc, and getwc
|
|
|
|
This is a follow-up to 10de4a47ef3f481592e3c62eb07bcda23e9fde4d that
|
|
reworded the manual entries for putc and putwc and removed any
|
|
performance claims.
|
|
|
|
This commit further clarifies these entries and brings getc and getwc in
|
|
line with the descriptions of putc and putwc, removing any performance
|
|
claims from them as well.
|
|
Reviewed-by: Florian Weimer <fweimer@redhat.com>
|
|
|
|
(cherry picked from commit 942670c81dc8071dd75d6213e771daa5d2084cb6)
|
|
|
|
diff --git a/manual/stdio.texi b/manual/stdio.texi
|
|
index c11d37b363385531..0b31aeff958528c6 100644
|
|
--- a/manual/stdio.texi
|
|
+++ b/manual/stdio.texi
|
|
@@ -904,20 +904,16 @@ This function is a GNU extension.
|
|
@standards{ISO, stdio.h}
|
|
@safety{@prelim{}@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@acucorrupt{} @aculock{}}}
|
|
This is just like @code{fputc}, except that it may be implemented as
|
|
-a macro, making it faster. One consequence is that it may evaluate the
|
|
-@var{stream} argument more than once, which is an exception to the
|
|
-general rule for macros. Therefore, @var{stream} should never be an
|
|
-expression with side-effects.
|
|
+a macro and may evaluate the @var{stream} argument more than once.
|
|
+Therefore, @var{stream} should never be an expression with side-effects.
|
|
@end deftypefun
|
|
|
|
@deftypefun wint_t putwc (wchar_t @var{wc}, FILE *@var{stream})
|
|
@standards{ISO, wchar.h}
|
|
@safety{@prelim{}@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@acucorrupt{} @aculock{}}}
|
|
This is just like @code{fputwc}, except that it may be implemented as
|
|
-a macro, making it faster. One consequence is that it may evaluate the
|
|
-@var{stream} argument more than once, which is an exception to the
|
|
-general rule for macros. Therefore, @var{stream} should never be an
|
|
-expression with side-effects.
|
|
+a macro and may evaluate the @var{stream} argument more than once.
|
|
+Therefore, @var{stream} should never be an expression with side-effects.
|
|
@end deftypefun
|
|
|
|
@deftypefun int putc_unlocked (int @var{c}, FILE *@var{stream})
|
|
@@ -1110,20 +1106,17 @@ This function is a GNU extension.
|
|
@deftypefun int getc (FILE *@var{stream})
|
|
@standards{ISO, stdio.h}
|
|
@safety{@prelim{}@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@aculock{} @acucorrupt{}}}
|
|
-This is just like @code{fgetc}, except that it is permissible (and
|
|
-typical) for it to be implemented as a macro that evaluates the
|
|
-@var{stream} argument more than once. @code{getc} is often highly
|
|
-optimized, so it is usually the best function to use to read a single
|
|
-character.
|
|
+This is just like @code{fgetc}, except that it may be implemented as
|
|
+a macro and may evaluate the @var{stream} argument more than once.
|
|
+Therefore, @var{stream} should never be an expression with side-effects.
|
|
@end deftypefun
|
|
|
|
@deftypefun wint_t getwc (FILE *@var{stream})
|
|
@standards{ISO, wchar.h}
|
|
@safety{@prelim{}@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@aculock{} @acucorrupt{}}}
|
|
-This is just like @code{fgetwc}, except that it is permissible for it to
|
|
-be implemented as a macro that evaluates the @var{stream} argument more
|
|
-than once. @code{getwc} can be highly optimized, so it is usually the
|
|
-best function to use to read a single wide character.
|
|
+This is just like @code{fgetwc}, except that it may be implemented as
|
|
+a macro and may evaluate the @var{stream} argument more than once.
|
|
+Therefore, @var{stream} should never be an expression with side-effects.
|
|
@end deftypefun
|
|
|
|
@deftypefun int getc_unlocked (FILE *@var{stream})
|