mbstowcs.3, wcstombs.3: Improve language relating to "initial state"

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

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-12 14:35:54 +02:00
parent a8a9227ded
commit 3942b6bcd2
2 changed files with 7 additions and 5 deletions

View File

@ -39,8 +39,9 @@ At most
.I n
wide characters are written to
.IR dest .
The conversion starts
in the initial state.
The sequence of characters in the string
.I src
shall begin in the initial shift state.
The conversion can stop for three reasons:
.IP 1. 3
An invalid multibyte sequence has been encountered.

View File

@ -36,8 +36,9 @@ At most
.I n
bytes are written to
.IR dest .
The conversion
starts in the initial state.
The sequence of characters placed in
.IR dest
begins in the initial shift state.
The conversion can stop for three reasons:
.IP 1. 3
A wide character has been encountered that can not be represented as a
@ -53,7 +54,7 @@ is returned, but the shift state at this point is lost.
.IP 3.
The wide-character string has been completely converted, including the
terminating null wide character (L\(aq\\0\(aq).
In this case, the conversion ends in the initial state.
In this case, the conversion ends in the initial shift state.
The number of bytes written to
.IR dest ,
excluding the terminating null byte (\(aq\\0\(aq), is returned.