From: Eli Zaretskii Date: Fri, 14 Jan 2022 07:26:20 +0000 (+0200) Subject: ; * INSTALL (Alternative window systems): Improve wording. X-Git-Tag: emacs-29.0.90~3076 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=fa1dd64ba890ae66c3541fb7af0f895fd8fea721;p=emacs.git ; * INSTALL (Alternative window systems): Improve wording. --- 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: