> mbrtoc32, c32rtomb \- convert between multibyte sequence and 32-bit wide character I would suggest two separate man pages for these functions. Rationale: It is rare that some code uses mbrtoc32 and c32rtomb in the same function. (Basically, functions that do input call mbrtoc32, and functions that do output call c32rtomb.) And the description of mbrtoc32 is a bit complex. > Are there any important differences compared to the already-documented > and C99-compliant mbrtowc(3) and wcrtomb(3)? I mean, apart from the > types of the parameters. No for c32rtomb, but yes for mbrtoc32: mbrtowc has the special return values (size_t)-1 and (size_t)-2, whereas mbrtoc32 also has the special return value (size_t)-3. Although, on glibc currently this special return value (size_t)-3 cannot occur. But IMO the man page should mention it nevertheless, otherwise people write code that is not future-proof. Bruno
