[Bug 210469] aio_xxx(3) manpages do not detail struct aiocb

bugzilla-noreply at freebsd.org bugzilla-noreply at freebsd.org
Wed Jun 22 16:02:00 UTC 2016


https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=210469

            Bug ID: 210469
           Summary: aio_xxx(3) manpages do not detail struct aiocb
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: freebsd-bugzilla at ayaken.net

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)

-- 
You are receiving this mail because:
You are the assignee for the bug.


More information about the freebsd-doc mailing list