mbsnrtowcs.3: Note behavior of mbsnrtowcs() for an incomplete character

Note the behavior of mbsnrtowcs() when an incomplete character
is found at end of the input buffer.

Reported-by: Igor Liferenko <igor.liferenko@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3
index 006bdf080df190253b4c1314e7232ebab1cdb316..4cceeb43f5534911b47c2cc289fd60dddb787eb6 100644 (file)
--- a/man3/mbsnrtowcs.3
+++ b/man3/mbsnrtowcs.3
@@ -127,6 +127,12 @@ characters written to
 excluding the terminating null wide character,
 is returned.
 .PP
+According to POSIX.1,
+if the input buffer ends with an incomplete character,
+it is unspecified whether conversion stops at the end of
+the previous character (if any), or at the end of the input buffer.
+The glibc implementation adopts the former behavior.
+
 If
 .IR dest
 is NULL,