Re: [bug-gnu-libiconv] Another suggested change to iconv_open man page

[Bruno Haible]

Hello,

Perry Rapp wrote:
> I suggest another change to the iconv_open man page.
> 
> There is an ERRORS section near the bottom, which
> lists EINVAL as a possible error.
> 
> I suggest adding also
> 
> ENOMEM
> 
>   An attempt to dynamically allocate memory failed

The POSIX documentation of iconv_open [1] also mentions ENOMEM. But I don't
think it's worth mentioning it in a manual page, since programmers usually
will not want to treat ENOMEM specially. Whereas an EINVAL error code is
usually treated specially, e.g. by trying different encoding arguments.

The phrase "among others" makes it clear that other errno values are possible.

Bruno


[1] http://www.opengroup.org/susv3/functions/iconv_open.html