This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
POSIX.pod: Clarify setlocale() text
authorKarl Williamson <khw@cpan.org>
Sat, 21 Dec 2019 21:35:30 +0000 (14:35 -0700)
committerKarl Williamson <khw@cpan.org>
Mon, 23 Dec 2019 14:28:41 +0000 (07:28 -0700)
ext/POSIX/lib/POSIX.pod

index f25360d..962ec1f 100644 (file)
@@ -1459,9 +1459,10 @@ L<thread|threads>.  The locale will change in all other threads at the
 same time, and should your thread get paused by the operating system,
 and another started, that thread will not have the locale it is
 expecting.  On some platforms, there can be a race leading to segfaults
-if two threads call this function nearly simultaneously.  On unthreaded
-builds, or on Perl 5.28 and later on thread-safe systems, this warning
-does not apply.
+if two threads call this function nearly simultaneously.  This warning
+does not apply on unthreaded builds, or on perls where
+C<${^SAFE_LOCALES}> exists and is non-zero; namely Perl 5.28 and later
+compiled to be locale-thread-safe.
 
 This function
 modifies and queries the program's underlying locale.  Users of this