summaryrefslogtreecommitdiff
path: root/sys/man/1
diff options
context:
space:
mode:
authorSigrid Solveig Haflínudóttir <sigrid@ftrv.se>2022-11-21 23:23:15 +0000
committerSigrid Solveig Haflínudóttir <sigrid@ftrv.se>2022-11-21 23:23:15 +0000
commit09bb5b77bc8b17de727b202b296091a286496d31 (patch)
tree5dadc0db5370e78484951636ba22f12ef8e9bd24 /sys/man/1
parent27ca3c1b0c109cb15fb3aa2baa152eaf9dc2eba3 (diff)
riow(1): provide better examples of how to run it (thanks be0ba)
Diffstat (limited to 'sys/man/1')
-rw-r--r--sys/man/1/riow27
1 files changed, 20 insertions, 7 deletions
diff --git a/sys/man/1/riow b/sys/man/1/riow
index b49f99603..5cc000cee 100644
--- a/sys/man/1/riow
+++ b/sys/man/1/riow
@@ -13,21 +13,33 @@ provides keyboard controlling for
in the manner of
.IR i3 ,
.I sway
-and so on. It does so by working with
+and
+.IR ratpoison .
+It does so by working with
.I /dev/kbdtap
(see \fIrio\fR(4)) and
.IR /dev/wsys .
+
+.I riow
+outputs the current desktop number onto fd 3, which can be used by programs like
+.IR bar (1).
.SS Running
+A minimal example of running
+.I riow
+with status output to
+.IR bar (1):
+.EX
+ window '</dev/kbdtap riow >/dev/kbdtap |[3] bar'
+.EE
+
Example of running
.I riow
with other programs handling input:
.EX
- </dev/kbdtap ktrans | \\
- reform/shortcuts | \\
- riow >/dev/kbdtap |[3] bar
+ window '</dev/kbdtap ktrans |
+ reform/shortcuts |
+ riow >/dev/kbdtap |[3] bar'
.EE
-Note that the current desktop number is printed to fd
-.IR 3 .
.SS Keyboard shortcuts
.TP
.B Kmod4+0…9
@@ -72,7 +84,8 @@ Same, but in bigger steps.
/sys/src/cmd/riow.c
.SH SEE ALSO
.IR bar (1),
-.IR rio (4)
+.IR rio (4),
+.IR ktrans (1)
.SH HISTORY
Riow first appeared in 9front (September, 2022).
.SH BUGS