Bug 210469 - aio_xxx(3) manpages do not detail struct aiocb
Summary: aio_xxx(3) manpages do not detail struct aiocb
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-06-22 16:02 UTC by Martin S. Weber
Modified: 2018-04-10 19:10 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Martin S. Weber 2016-06-22 16:02:00 UTC
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)