man/io_uring_enter.2: clarify io_uring_enter(2) return values
With the recent change to ensure that submission side errors that
happen on behalf of an sqe are returned in the form of a cqe rather
than -1/errno from the system call, make sure that the man page
reflects that.
@@ -305,13 +305,15 @@ description of the opcodes above.
.PP
.SH RETURN VALUE
.BR io_uring_enter ()
-returns the number of I/Os successfully submitted. This can be zero
+returns the number of I/Os successfully consumed. This can be zero
if
.I to_submit
-was zero, if there were invalid entries in the submission queue, or if
-the submission queue was empty.
+was zero or if the submission queue was empty. The errors below that refer to
+an error in a submission queue entry will be returned though a completion queue
+entry, rather than through the system call itself.
-On error, -1 is returned and
+Errors that occur not on behalf of a submission queue entry are returned via the
+system call directly. On such an error, -1 is returned and
.I errno
is set appropriately.
.PP
