Added the latest changes

1 files changed, 40 insertions, 16 deletions

diff --git a/surf.1 b/surf.1
index c1a7744..1034fb8 100644
--- a/surf.1
+++ b/surf.1
@@ -7,16 +7,16 @@ surf \- simple webkit-based browser
 .RB [-a\ cookiepolicies]
 .RB [-c\ cookiefile]
 .RB [-C\ stylefile]
-.RB [-e\ xid]
 .RB [-r\ scriptfile]
 .RB [-u\ useragent]
 .RB [-z\ zoomlevel]
 .RB [URI]
 .SH DESCRIPTION
-surf is a simple Web browser based on WebKit/GTK+. It is able
-to display websites and follow links. It supports the XEmbed protocol
-which makes it possible to embed it in another application. Furthermore,
-one can point surf to another URI by setting its XProperties.
+surf is a simple Web browser based on WebKit/GTK+, running as a native
+Wayland client. It is able to display websites and follow links.
+Furthermore, one can point surf to another URI by writing to the control
+fifo of its window, see
+.BR "CONTROL FIFO" .
 .SH OPTIONS
 .TP
 .B \-a cookiepolicies
@@ -51,10 +51,6 @@ Disable the disk cache.
 .B \-D
 Enable the disk cache.
 .TP
-.B \-e xid
-Reparents to window specified by
-.IR xid .
-.TP
 .B \-f
 Start surf in windowed mode (not fullscreen).
 .TP
@@ -116,9 +112,9 @@ which surf should use.
 Prints version information to standard output, then exits.
 .TP
 .B \-w
-Prints xid to standard output. This can be used to script the browser in for
-example
-.BR xdotool(1) .
+Prints the path of the window's control fifo to standard output, so that
+scripts can drive the browser without having to guess the path. See
+.BR "CONTROL FIFO" .
 .TP
 .B -x
 Disable custom certificates.
@@ -285,6 +281,37 @@ no proxy
 .TP
 .B P
 using proxy
+.SH CONTROL FIFO
+Each window creates a fifo
+.IR $XDG_RUNTIME_DIR/surf/pid-pageid ,
+whose path is printed by
+.BR \-w .
+Writing a line of the form
+.I "command argument"
+to it drives that window:
+.TP
+.B uri \fIURI\fR
+Load
+.IR URI ,
+resolved the same way as a
+.I URI
+given on the command line.
+.TP
+.B find \fItext\fR
+Search the page for
+.IR text .
+An empty
+.I text
+aborts the search.
+.PP
+For example:
+.PP
+.RS
+printf 'uri %s\\n' https://suckless.org >"$XDG_RUNTIME_DIR"/surf/*
+.RE
+.PP
+The fifo is removed when the window closes; a stale one is left behind if
+surf is killed. No fifo is created in kiosk mode.
 .SH ENVIRONMENT
 .B SURF_USERAGENT
 If this variable is set upon startup, surf will use it as the
@@ -297,9 +324,6 @@ If this variable is set and not empty upon startup, surf will use it as the http
 Surf will reload the current page on
 .BR SIGHUP .
 .SH SEE ALSO
-.BR dmenu(1),
-.BR xprop(1),
-.BR tabbed(1),
-.BR xdotool(1)
+.BR dmenu(1)
 .SH BUGS
 Please report them!