; * INSTALL (Alternative window systems): Improve wording.

diff --git a/INSTALL b/INSTALL
index a76a1f57443b1baf180d1a7f8beb4cbf6e7d92d5..7cb7e0526a2101cbe295b068d8033f79ab0f388a 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -230,28 +230,29 @@ On FreeBSD, the command is 'pkg install -y `pkg rquery %dn emacs-devel`'.
 
 If you want to use Emacs on one of the alternative window systems
 available on GNU/Linux and some Unix systems, such as Wayland or
-Broadway, you can install the PGTK port of Emacs, which utilizes the
-GTK+ toolkit to support them, by passing '--with-pgtk' to configure,
-like this:
+Broadway, you can build the PGTK ("Pure GTK") port of Emacs, which
+utilizes the GTK+ toolkit to support those window systems.  To this
+end, invoke the configure script with the '--with-pgtk' option, like
+this:
 
        ./configure --with-pgtk
 
-Keep in mind that the only toolkit which will work with this option is
-GTK+ version 3, and specifying any X-specific configuration option is an
-error when it is enabled.
+This build is only supported with GTK+ version 3, and it is an error
+to specify any other X-specific configuration option when PGTK is
+enabled.
 
-Afterwards, you will be able to switch between running Emacs on X,
-Wayland and Broadway using the 'GDK_BACKEND' environment variable.
-GTK+ should automatically detect and use the correct value for your
-system, but you may have to specify it manually.  For example, you
-must run Emacs like this to force GTK+ to run under Broadway:
+With the PGTK build, you will be able to switch between running Emacs
+on X, Wayland and Broadway using the 'GDK_BACKEND' environment
+variable.  GTK+ should automatically detect and use the correct value
+for your system, but you can also specify it manually.  For example,
+to force GTK+ to run under Broadway, start Emacs like this:
 
        GDK_BACKEND=broadway emacs ...
 
-Where '...' denotes any further options you may want to pass to Emacs.
+(where '...' denotes any further options you may want to pass to Emacs).
 
-GNUstep also has support for the Wayland window system.  If that is what
-you want, see nextstep/INSTALL.
+The GNUstep build also supports the Wayland window system.  If that is
+what you want, see nextstep/INSTALL.
 
 DETAILED BUILDING AND INSTALLATION: