Re: [groff] Asynchronous events

[James K. Lowden]

On Wed, 12 Dec 2018 03:32:11 +0100
Ingo Schwarze <address@hidden> wrote:

>  * ERRORS.
>    Most system call pages and many library function pages have
>    this section, but the information being complete is the
>    exception rather than the norm.  Even in OpenBSD.

That's especially true for network functions.  And unnecessary: static
analysis could report every function call and every value of errno
set by each function.  That database could be compared to the
enumerated set in the documentation; the man pages could even be
automatically updated to reflect the potential (undocumented)
diagnostics and their origins.  Then guys like Branden could swoop in
and fix the semi-corrected documentation.  

A similar scan for diagnostics could be made for calls to err(3) and
friends.  Yes, errors are emitted other ways, but if the scan was
conducted periodically, it would encourage use of the those functions. 

Only a matter of time. 

--jkl