From 9c0a6042d2d9ad43dc2bc1f66f969ca35963003d Mon Sep 17 00:00:00 2001
From: Michael Albinus <michael.albinus@gmx.de>
Date: Thu, 12 Jul 2007 21:13:06 +0000
Subject: [PATCH] * tramp.texi (Remote processes): Don't call it "experimental"
 any longer.  Add subsection about running a debugger on a remote host.

---
 man/ChangeLog  |  5 +++++
 man/tramp.texi | 58 ++++++++++++++++++++++++++++++++++++++------------
 2 files changed, 49 insertions(+), 14 deletions(-)

diff --git a/man/ChangeLog b/man/ChangeLog
index 65173aa2f5d..2509f926f58 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,8 @@
+2007-07-12  Michael Albinus  <michael.albinus@gmx.de>
+
+	* tramp.texi (Remote processes): Don't call it "experimental" any
+	longer.  Add subsection about running a debugger on a remote host.
+
 2007-07-10  Carsten Dominik  <dominik@science.uva.nl>
 
 	* org.texi (Properties and columns): Chapter rewritten.
diff --git a/man/tramp.texi b/man/tramp.texi
index fbcce166636..de72b6abaf3 100644
--- a/man/tramp.texi
+++ b/man/tramp.texi
@@ -212,7 +212,7 @@ Using @value{tramp}
 * Filename Syntax::             @value{tramp} filename conventions.
 * Alternative Syntax::          URL-like filename syntax.
 * Filename completion::         Filename completion.
-* Remote processes::            Integration with other @value{emacsname} packages (@sc{experimental}).
+* Remote processes::            Integration with other @value{emacsname} packages.
 
 The inner workings of remote version control
 
@@ -2019,7 +2019,7 @@ minute you have already forgotten that you hit that key!
 * Filename Syntax::             @value{tramp} filename conventions.
 * Alternative Syntax::          URL-like filename syntax.
 * Filename completion::         Filename completion.
-* Remote processes::            Integration with other @value{emacsname} packages (@sc{experimental}).
+* Remote processes::            Integration with other @value{emacsname} packages.
 @end menu
 
 
@@ -2228,17 +2228,14 @@ contents to @file{/}.
 
 
 @node Remote processes
-@section Integration with other @value{emacsname} packages (@sc{experimental}).
+@section Integration with other @value{emacsname} packages.
 @cindex compile
 @cindex recompile
-@cindex gud
-@cindex gdb
-@cindex perldb
 
-@value{tramp} has an @sc{experimental} implementation for running
-processes on a remote host.  This allows to exploit @value{emacsname}
-packages without modification for remote file names.  It does not work
-for the @option{ftp} and @option{smb} methods.
+@value{tramp} supports running processes on a remote host.  This
+allows to exploit @value{emacsname} packages without modification for
+remote file names.  It does not work for the @option{ftp} and
+@option{smb} methods.
 
 Remote processes are started when a corresponding command is executed
 from a buffer belonging to a remote file or directory.  Up to now, the
@@ -2298,17 +2295,50 @@ After you have started @code{eshell}, you could perform commands like
 this:
 
 @example
-@b{~ $} cd @trampfnmhl{sudo, , /etc}
-@b{@trampfn{sudo, root, host, /etc} $} hostname
+@b{~ $} cd @trampfnmhl{sudo, , /etc} @key{RET}
+@b{@trampfn{sudo, root, host, /etc} $} hostname @key{RET}
 host
-@b{@trampfn{sudo, root, host, /etc} $} id
+@b{@trampfn{sudo, root, host, /etc} $} id @key{RET}
 uid=0(root) gid=0(root) groups=0(root)
-@b{@trampfn{sudo, root, host, /etc} $} find-file shadow
+@b{@trampfn{sudo, root, host, /etc} $} find-file shadow @key{RET}
 #<buffer shadow>
 @b{@trampfn{sudo, root, host, /etc} $}
 @end example
 
 
+@subsection Running a debugger on a remote host
+@cindex gud
+@cindex gdb
+@cindex perldb
+
+@file{gud.el} offers an unified interface to several symbolic
+debuggers
+@ifset emacs
+@ifinfo
+(@ref{Debuggers, , , @value{emacsdir}}).
+@end ifinfo
+@end ifset
+With @value{tramp}, it is possible to debug programs on
+remote hosts.  You can call @code{gdb} with a remote file name:
+
+@example
+@kbd{M-x gdb @key{RET}}
+@b{Run gdb (like this):} gdb --annotate=3 @trampfnmhl{ssh, host, ~/myprog} @key{RET}
+@end example
+
+The file name can also be relative to a remote default directory.
+Given you are in a buffer that belongs to the remote directory
+@trampfnmhl{ssh, host, /home/user}, you could call
+
+@example
+@kbd{M-x perldb @key{RET}}
+@b{Run perldb (like this):} perl -d myprog.pl @key{RET}
+@end example
+
+It is not possible to use just the absolute local part of a remote
+file name, like @kbd{perl -d /home/user/myprog.pl}, though.
+
+
 @node Bug Reports
 @chapter Reporting Bugs and Problems
 @cindex bug reports
-- 
2.39.2