ticket:10903 u_strToUTF8WithSub(), API docs misleading regarding error status setting.

git-svn-id: http://source.icu-project.org/repos/icu/icu/trunk/source@35991 251d0590-4201-4cf1-90de-194747b24ca1