Philip Guenther <guent...@gmail.com> wrote:
> > The man pages for readv and writev don't document the possibility of
> > such errors.
>
>
> IMO, weird errnos from devices should be documented in the manpage for the
> device. Consider the termios(4) manpage, for example.
I agree on that. Otherwise the information-flood is too much.
But I think some of our manual pages are a bit weak indicating there
are other errors not listed:
ERRORS
read(), readv(), pread(), and preadv() will succeed unless:
[...]
In addition, read() and readv() may return the following errors:
[...]
read() and pread() may return the following error:
[...]
pread() and preadv() may return the following errors:
[...]
readv() and preadv() may return one of the following errors:
[...]
SEE ALSO
Written that way, it is easy for some folk to conclude the list is
complete, and no other errors could pop out. We have more experience
and recognize slightly more unique error returns are valuable.
Maybe it needs a bit of "Amongst our errors...", can we force jmc or
ingo into a fancy chair to review the situation?
