tags 839705 fixed-upstream thanks On 10/04/2016 09:30 AM, Igor Liferenko wrote: > Package: manpages-dev > Version: 4.07-1 > Severity: normal > > Dear Maintainer, > > In mbstowcs(3) there is this sentence: > > The conversion starts in the initial state. > > And in wcstombs(3) there are these sentences: > > The conversion starts in the initial state. > > In this case, the conversion ends in the initial state. > > "Initial state" is associated only with mbstate_t, but mbstowcs and wcstombs > are stateless (in contrast with mbsrtowcs and wcsrtombs).
Looking at your later reply, you seem to understand that "Initial state" here is sort of okay. But really, the language could be clearer. I applied the patch below. (Still not sure if it's 100% correct, but I believe it's an improvement.) Cheers, Michael diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index e02f7df..bdd624a 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -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. diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index e5498b3..073cc9b 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -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. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
