]> git.eshelyaron.com Git - emacs.git/commitdiff
Add PROBLEMS entry for bug#72303
authorPo Lu <luangruo@yahoo.com>
Fri, 26 Jul 2024 12:14:43 +0000 (20:14 +0800)
committerEshel Yaron <me@eshelyaron.com>
Sat, 27 Jul 2024 12:03:08 +0000 (14:03 +0200)
* etc/PROBLEMS (Runtime problems specific to PGTK build):
Document that text mode sessions cannot be started without
`-nw'.  (bug#72303)

(cherry picked from commit 309d0a718644385eb73f40c5eaa967e9b1548353)

etc/PROBLEMS

index f8fb9f90c0bc6d8b60f2ad01950cd8afad5dd32d..c1ad8321fa677452076929fd4f988681c01aa37b 100644 (file)
@@ -3472,6 +3472,22 @@ file; for example:
 
 * Runtime problems specific to PGTK build
 
+** Whether a display server is available cannot be automatically detected.
+
+When started with no arguments from a text terminal and in an
+environment where no display server is specified, Emacs will print:
+
+  $ emacs
+  (emacs:3988): Gtk-WARNING **: 19:19:10.887: cannot open display:
+
+and exit.  This is a byproduct of GTK's not providing any means of
+probing for a display connection before committing to opening one, and
+cannot be addressed by Emacs.  Rather, users must expressly request a
+text mode session:
+
+  $ emacs -nw
+  [...]
+
 ** SECONDARY selections don't work on Wayland.
 
 This is because the SECONDARY selection is not implemented by the