summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2022-01-14 09:26:20 +0200
committerEli Zaretskii <eliz@gnu.org>2022-01-14 09:26:20 +0200
commitfa1dd64ba890ae66c3541fb7af0f895fd8fea721 (patch)
tree1e542e0207cf51678342c126a662581cdff4c2a8 /INSTALL
parent9cc1344c9fbec39cf193a745e2720f1e008ff2f6 (diff)
downloademacs-fa1dd64ba890ae66c3541fb7af0f895fd8fea721.tar.gz
; * INSTALL (Alternative window systems): Improve wording.
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL29
1 files changed, 15 insertions, 14 deletions
diff --git a/INSTALL b/INSTALL
index a76a1f57443..7cb7e0526a2 100644
--- 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: