aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2016-10-12 14:35:54 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2016-10-12 16:03:38 +0200
commit3942b6bcd224490bffd794e82a577defc276fb88 (patch)
tree82ac9c58c663d9cdb0ac591245b2284d39c8ed5b
parenta8a9227ded319bc41d55921ca049422810083aff (diff)
downloadman-pages-3942b6bcd224490bffd794e82a577defc276fb88.tar.gz
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>
-rw-r--r--man3/mbstowcs.35
-rw-r--r--man3/wcstombs.37
2 files changed, 7 insertions, 5 deletions
diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3
index e02f7dfcbd..bdd624ae91 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 e5498b3ff4..073cc9b76a 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.