Bug#838956: manpages-dev: Inconsistent documentation in NOTES section of "man wcstombs"

[Michael Kerrisk (man-pages)]

tags 838956 fixed-upstream
thanks

Thanks for this report. I've applied the patch below to the upstream man page.

Cheers,

Michael


diff --git a/man3/wcstombs.3 b/man3/wcstombs.3
index c787250..1f189be 100644
--- a/man3/wcstombs.3
+++ b/man3/wcstombs.3
@@ -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),


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Bug#838956: manpages-dev: Inconsistent documentation in NOTES section of "man wcstombs"

[Igor Liferenko]

Package: manpages-dev
Version: 4.07-1
Severity: normal

Dear Maintainer,

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.

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 4.6.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages manpages-dev depends on:
ii  manpages  4.07-1

manpages-dev recommends no packages.

Versions of packages manpages-dev suggests:
ii  man-db [man-browser]  2.7.5-1

-- no debconf information