From 0625f470e0956a3a337e4999f6712ec7b7d872e5 Mon Sep 17 00:00:00 2001
From: Mateusz Piotrowski <0mp@FreeBSD.org>
Date: Thu, 9 Oct 2025 17:47:25 +0200
Subject: [PATCH] uio.9: Improve description of uio_rw flags

The direction of the data transfer in uio(9) can be confusing,
so state explicitly the difference between UIO_READ and UIO_WRITE.

Reviewed by:	ziaee
MFC after:	3 days
Differential Revision:	https://reviews.freebsd.org/D52996
---
 share/man/man9/uio.9 | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/share/man/man9/uio.9 b/share/man/man9/uio.9
index e6240c4e51d..b143eb6e8e6 100644
--- a/share/man/man9/uio.9
+++ b/share/man/man9/uio.9
@@ -23,7 +23,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 11, 2017
+.Dd October 22, 2025
 .Dt UIO 9
 .Os
 .Sh NAME
@@ -107,10 +107,14 @@ The I/O vector points into the kernel address space.
 Do not copy, already in object.
 .El
 .It Va uio_rw
-The direction of the desired transfer, either
-.Dv UIO_READ
-or
-.Dv UIO_WRITE .
+The direction of the desired transfer.
+The supported flags are:
+.Bl -tag -width "UIO_WRITE"
+.It Dv UIO_READ
+Transfer data from the buffers into the I/O vectors.
+.It Dv UIO_WRITE
+Transfer data from the I/O vectors into the buffers.
+.El
 .It Va uio_td
 The pointer to a
 .Vt "struct thread"