From: Sean Whitton <spwhitton@spwhitton.name>
Date: Tue, 19 Apr 2022 02:43:32 +0000 (-0700)
Subject: Tell those using exclusively X not to use the PGTK port
X-Git-Tag: emacs-29.0.90~1931^2~417
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5fae0325872710dcbf42541b985103b66f613f61;p=emacs.git

Tell those using exclusively X not to use the PGTK port

* INSTALL (Alternative window systems): Tell those using exclusively X
not to use the PGTK port.
---

diff --git a/INSTALL b/INSTALL
index b1e3c72c4bf..f2687225daf 100644
--- a/INSTALL
+++ b/INSTALL
@@ -243,6 +243,11 @@ 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.
 
+If you use exclusively X, do not use the PGTK port.  There are a
+number of respects in which the regular --with-x-toolkit=gtk build
+works better.  The PGTK port should not be considered a simple upgrade
+from --with-x-toolkit=gtk.
+
 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