compare aio_write(3) to poll(2). While the former mentions the structure members scattered through the text, poll(2) gives a (view of the public interface of) struct pollfd. This is helpful information as it prevents you from hunting header files just to see the members of the struct you ought to touch and is generally IMO preferable to just scattering member mentions through the prose of the description. Suggest documenting the (public API portion of) struct aiocb in aio_xxx(3)
Created attachment 228181 [details] aio_read(2) and aio_write(2) patch Update aio_write(2) and aio_read(2) to document struct aiocb (bug #210469), mention lio_listio(2) in the SEE ALSO section (bug #210467), and remove references to private members of struct aiocb (bug #210468).