On Mon, Dec 23, 2019 at 6:07 AM Ingo Schwarze <schwa...@usta.de> wrote:
> Theo de Raadt wrote on Sun, Dec 22, 2019 at 05:34:45PM -0700: > > Philip Guenther <guent...@gmail.com> wrote: > >> Somebody 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: > > Is the following good enough? > > Or are you saying that *all* section 2 and 3 manual pages should be > reworded to say: "FOOBAR may for example fail if:"? > Not all. For section 2 it's the calls that take an fd that need to be open-ended about errors. Philip Guenther