shithub: riscv

Download patch

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