Explain gdb warning on remote hosts

* doc/misc/tramp.texi (Remote processes): Explain gdb warning
on remote hosts.  (Bug#4604, Bug#6360, Bug#622569)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 8a144a5d023d413ae21c779ad2e6229c53170103..4dc5e750bc56816c9f7da22ea40012a810f75bfd 100644 (file)
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2604,10 +2604,18 @@ with a remote file name:
 @example
 @group
 @kbd{M-x gdb @key{RET}}
-@b{Run gdb (like this):} gdb --annotate=3 @trampfn{ssh,host,~/myprog} @key{RET}
+@b{Run gdb (like this):} gdb -i=mi @trampfn{ssh,host,~/myprog} @key{RET}
 @end group
 @end example
 
+Since the remote @code{gdb} and @code{gdb-inferior} processes do not
+belong to the same process group on the remote host, there will be a
+warning, which can be ignored:
+
+@example
+&"warning: GDB: Failed to set controlling terminal: Operation not permitted\n"
+@end example
+
 Relative file names are based on the remote default directory.  When
 @file{myprog.pl} exists in @file{@trampfn{ssh,host,/home/user}}, valid
 calls include: