From 2b17ddc2cfec5118aa576dc6a740af4de023e1e4 Mon Sep 17 00:00:00 2001
From: Henrik Lissner <git@henrik.io>
Date: Sat, 20 Sep 2025 16:11:28 -0400
Subject: [PATCH] docs(tramp): mention gdb-mi incompatibility

Ref: #8510
---
 modules/emacs/tramp/README.org | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/modules/emacs/tramp/README.org b/modules/emacs/tramp/README.org
index cf27f06f7..054f11028 100644
--- a/modules/emacs/tramp/README.org
+++ b/modules/emacs/tramp/README.org
@@ -54,7 +54,12 @@ SCP, FTP, and more.
 #+end_quote
 
 * Troubleshooting
-/There are no known problems with this module./ [[doom-report:][Report one?]]
+[[doom-report:][Report an issue?]]
+
+** Known compatibility issues
+- gdb-mi (via ~M-x gdb~) ::
+  Doesn't work with direct-async enabled. To get around this, add ~set debuginfod
+  enabled~ to =~/.gdbinit=. (Reported in #8510)
 
 * Frequently asked questions
 /This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]]