Hi Jon,

On Mon, Oct 3, 2011 at 8:34 PM, Jon Grant [off-list ref] wrote:

Hello

I noticed that aio(7) contains a description of the each function,
e.g. aio_read(3). I noticed that descriptions are a little different.
Could the text be the same for both? I don't intend this to sound
pedantic! The pages are great :)


e.g.

http://man7.org/linux/man-pages/online/pages/man7/aio.7.html

"aio_cancel(3)   Attempt to cancel outstanding I/O requests on a specified file
                      descriptor."

"aio_suspend(3)  Suspend the caller until one or more of a specified set of I/O
                      requests completes."



http://man7.org/linux/man-pages/online/pages/man3/aio_cancel.3.html
"aio_cancel - cancel an outstanding asynchronous I/O request"

http://man7.org/linux/man-pages/online/pages/man3/aio_suspend.3.html
"aio_suspend - wait for asynchronous I/O operation or timeout"

The one line descriptions in the SH section of man pages are usually
always very short. aio(7) had room to allow for longer descriptions. I
don't think any change is needed.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html