oops

cmd/wmiir.1

@@ -3,69 +3,81 @@
 wmiir \- window manager improved 2 remote
 .SH SYNOPSIS
 .B wmiir
-.RB [ \-s
-.IR socketfile ]
+.RB [ \-a
+.IR address ]
 .I action
-.I action_arg
-[...]
-.br
-.B wmiir
-.RB [ \-s
-.IR socketfile ]
-.B \-f
+.I file
 .br
 .B wmiir
 .B \-v
 .SH DESCRIPTION
 .SS Overview
 .B wmiir
-is a client to access wmii* fileservers for the command line and
-scripts. It can be used to configure wmii(1).
+is a client to access wmii's filesystem from the command line or from shell
+scripts. It can be used to configure
+.BR wmii (1).
 .SS Options
 .TP
-.BI \-s " socketfile"
-lets you specify the socketfile to which
+.BI \-a " address"
+Lets you specify the address to which
 .B wmiir
-a connection will be established. If the environment variable
-.B WMIIR_SOCKET
-is set and points to a socket file, wmiir will use that file, if this
-option is not supplied.
-.TP
-.B \-f
-reads from stdin, useful for interactive wmiir sessions or for
-scripts that write/read a bunch of data, because this speeds things up
-due to missing process creation/destruction, ie., a hack.
+will establish a connection. If this option is not supplied, and the
+environment variable WMII_ADDRESS is set,
+.B wmiir
+will use this value as it's address. Currently, the address can only be a
+socket file. The syntax for
+.I address
+is taken (along with many other profound ideas) from the Plan 9 operating
+system and has the form
+.BR unix!/path/to/socket .
 .TP
 .B \-v
-prints version information to stderr, then exits.
+Prints version information to stderr, then exits.
 .TP
 The syntax of the actions is as follows:
 .TP
-.B create <path/file> [<value>]
-creates file
+.B write
+Writes the supplied data from stdin to
+.IR file,
+overwriting any previous data.  The data to be written is arbitrary
+and only gains meaning (and restrictions) when it is interpreted by
+.BR wmiiwm (1).
+See
+.B EXAMPLES
+below.
 .TP
-.B write  <file> <value>
-writes value to a file
+.B create
+Creates file or directory but does not write any data. If the file exists,
+nothing is done.
 .TP
-.B read   <path/file>
-reads file or directory contents
+.B read
+Reads file or directory contents
 .TP
-.B remove <path/file>
-removes file or directory tree
+.B remove
+Removes file or directory tree
 .SH ENVIRONMENT
 .TP
-WMIIR_SOCKET
+WMII_ADDRESS
 See above.
 .SH EXAMPLES
 .TP
-$ wmiir read /
-This gives you an idea about what the wmii filesystem currently looks like.
+.B wmiir read /
+This displays the root of the wmii filesystem. For more information about the
+contents of this filesystem, see
+.BR wmiiwm (1).
 .TP
-$ wmiir write /wm/ctl quit
+.B echo -n quit | wmiir write /ctl
+Write 'quit' to the main control file of the wmii filesystem, effectively
+leaving wmii.
+.TP
+.B echo -n select 2 | wmiir write /ctl
+Bring into view all clients having a tag of '2'. To learn about clients and
+tags, see
+.BR wmiiwm (1).
 .SH SEE ALSO
-.BR wmiibar (1),
-.BR wmiifs (1),
 .BR wmii (1),
-.BR wmiiwm (1),
-.BR wmiikeys (1),
-.BR wmiimenu (1)
+.BR wmiiwm (1)
+
+http://www.cs.bell-labs.com/sys/man/5/INDEX.html
+.br
+http://v9fs.sf.net/

rc/wmiirc

@@ -7,7 +7,7 @@ xwrite() {
 }
 
 proglist() {
-	ls -lL `echo "$@" 2>/dev/null | tr : ' '` |
+	ls -lL `echo "$@" | tr : ' '` 2>/dev/null |
 	awk 'NF>2 && !/^d/ && $1 ~ /x/ {print $NF}' | sort -u
 }