From 744475a503e3af4597a4a038c3686c25abb48ee0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sigrid=20Solveig=20Hafl=C3=ADnud=C3=B3ttir?=
 <sigrid@ftrv.se>
Date: Sat, 5 Nov 2022 23:41:43 +0000
Subject: read: add -r to read runes instead of bytes (thanks umbraticus)

---
 sys/man/1/cat | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

(limited to 'sys/man')

diff --git a/sys/man/1/cat b/sys/man/1/cat
index 778cb5b42..3c14ee67d 100644
--- a/sys/man/1/cat
+++ b/sys/man/1/cat
@@ -10,12 +10,15 @@ cat, read \- catenate files
 .B read
 [
 .B -m
-] [
+|
 .B -n
 .I nlines
-] [
+|
 .B -c
 .I nbytes
+|
+.B -r
+.I nrunes
 ] [
 .I file ...
 ]
@@ -59,20 +62,14 @@ flag causes it to continue reading and writing multiple lines until end of file;
 causes it to read no more than
 .I nlines
 lines.
-.PP
-With the
+The
 .B -c
-flag,
-.I read
-copies exactly
-.I nbytes
-of characters instead of lines. It is mutually exclusive with
-.B -n
 and
-.B -m
-flag.
+.B -r
+flags specify a number of bytes or runes to read instead of lines.
 .PP
-.I Read
+When reading lines,
+.I read
 always executes a single
 .B write
 for each line of input, which can be helpful when
-- 
cgit v1.2.3