docs: Update broadway docs

Using Broadway without broadwayd hasn't worked since 2013...

Fixes: #5662

diff --git a/docs/reference/gtk/broadway.md b/docs/reference/gtk/broadway.md
index 99987845cfeb7fd975ff63f115c7cf1814546d17..6877dd0c02609dc976c9dd0739b39ea2dc43a45e 100644 (file)
--- a/docs/reference/gtk/broadway.md
+++ b/docs/reference/gtk/broadway.md
@@ -6,22 +6,15 @@ Slug: broadway
 The GDK Broadway backend provides support for displaying GTK applications in
 a web browser, using HTML5 and web sockets.
 
-To run your application in this way, select the Broadway backend by setting
-`GDK_BACKEND=broadway`. Then you can make your application appear in a web
-browser by pointing it at `http://127.0.0.1:8080`. Note that you need to
-enable web sockets in your web browser.
-
-You can choose a different port from the default 8080 by setting the
-`BROADWAY_DISPLAY` environment variable to the port that you want to use.
-
-It is also possible to use multiple GTK applications in the same web browser
-window, by using the Broadway server, `gtk4-broadwayd`, that ships with GTK.
-To start the Broadway server use:
+To run your application in this way, first run the broadway server,
+`gtk-broadwayd`, that ships with GTK:
 
 ```
 gtk4-broadwayd :5
 ```
 
+The server expects the colon-prefixed display number as a commandline argument.
+
 Then point your web browser at `http://127.0.0.1:8085`.
 
 Once the Broadway server is running, you can start your applications like
@@ -31,6 +24,8 @@ this:
 GDK_BACKEND=broadway BROADWAY_DISPLAY=:5 gtk4-demo
 ```
 
+Multiple applications can be presented in the same web browser window.
+
 ## Broadway-specific environment variables
 
 ### `BROADWAY_DISPLAY`