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

This commit is contained in:
Eli Zaretskii 2022-01-14 09:26:20 +02:00
parent 9cc1344c9f
commit fa1dd64ba8

29
INSTALL
View file

@ -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: