wcstombs.3: wcsrtombs() does not provide thread-safe interface to same functionality

As noted in the Debian bug:

In "man wcstombs" the words

    The function wcsrtombs(3) provides a thread safe interface to
    the same functionality.

should be changed to

    The function wcsrtombs(3) provides a better interface to
    the same functionality.

Because

1) wcsrtombs is not thread safe if "ps" is NULL (see "ATTRIBUTES"
   in "man wcsrtombs")

2) wcstombs *is* thread safe (see "ATTRIBUTES" in "man wcstombs")

3) "man mbstowcs" says "The function mbsrtowcs(3) provides a
   better interface to the same functionality." in the same
   NOTES section.

See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360

Reported-by: Igor Liferenko <igor.liferenko@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-02 14:20:42 +02:00
parent 49d2adfabd
commit fdcc06eeb1
1 changed files with 1 additions and 2 deletions

View File

@ -112,8 +112,7 @@ current locale.
.PP
The function
.BR wcsrtombs (3)
provides a thread safe interface to
the same functionality.
provides a better interface to the same functionality.
.SH SEE ALSO
.BR mblen (3),
.BR mbstowcs (3),