ref: f70cf0b70eb2b9b6cdf7208bf775189c724eb446
parent: 276c090a9536c0165d10d908862a93e743d3b344
author: Jacob Moody <moody@posixcafe.org>
date: Sun Nov 19 13:16:55 EST 2023
rio(1), rio(4): wctl /srv pipe is dead, mention 'none' attach (thanks unobe)
--- a/sys/man/1/rio
+++ b/sys/man/1/rio
@@ -488,7 +488,6 @@
it interprets all mouse events, gets all keyboard characters,
and determines what appears on the screen.
.SH FILES
-.TF /srv/riowctl.\fIuser\fP.\fIpid\fP
.TP
.B /lib/font/bit/*
font directories
@@ -505,11 +504,6 @@
.B /srv/rio.\fIuser\fP.\fIpid\fP
Server end of
.IR rio .
-.TP
-.B /srv/riowctl.\fIuser\fP.\fIpid\fP
-Named pipe for
-.I wctl
-messages.
.SH SOURCE
.TF /sys/src/cmd/rio
.TP
--- a/sys/man/4/rio
+++ b/sys/man/4/rio
@@ -39,16 +39,6 @@
is set to this service name within processes running under the control
of each invocation of
.IR rio .
-Similarly,
-.I rio
-posts a named pipe to access the window creation features
-(see
-.B window
-in
-.IR rio (1))
-from outside
-its name space; this is named in
-.BR $wctl .
.PP
A
.I mount
@@ -56,24 +46,12 @@
.IR bind (1))
of
.B $wsys
-causes
-.I rio
-to create a new window; the attach specifier in the
-.I mount
-gives the coordinates of the created window.
-The syntax of the specifier is the same as the arguments to
-.B window
-(see
-.IR rio (1)).
-By default, the window is sized and placed automatically.
-It is always necessary, however, to provide the process id of the
-process to whom to deliver notes generated by DEL characters and hangups
-in that window.
-That pid is specified by including the string
-.B -pid
-.I pid
-in the attach specifier. (See the Examples section
-.IR q.v. )
+must specify a context under which the files are presented. There are three
+ways to specify a context via the attach specifier. An existing
+window id may be supplied to attach to their existing context, instructions may
+be given to create a new window (see wctl described below), or
+.B none
+may be given to gain a windowless context.
.PP
When a window is created either by
the
@@ -348,14 +326,6 @@
.B -pid
.I pid
is implemented.
-.IP
-So programs outside name spaces controlled by
-.I rio
-may create windows,
-.B wctl
-.B new
-messages may also be written to the named pipe identified by
-.BR $wctl .
.TP
.B wdir
is a read/write text file containing
@@ -427,6 +397,13 @@
.IP
.EX
lp /dev/wsys/123/window
+.EE
+.PP
+Access wctl from outside of rio using a none attach:
+.IP
+.EX
+mount /srv/rio.$user.$riopid /tmp/ none
+echo new -dx 800 -dy 200 rc > /tmp/wctl
.EE
.SH SOURCE
.B /sys/src/cmd/rio