* process.texi (Asynchronous Processes):

* files.texi (Magic File Names): Add `start-file-process'.

3 files changed, 25 insertions, 1 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 1e5e94258b..5c25f0945a 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2007-07-07  Michael Albinus  <michael.albinus@gmx.de>
+
+	* process.texi (Asynchronous Processes):
+	* files.texi (Magic File Names): Add `start-file-process'.
+
 2007-06-27  Richard Stallman  <rms@gnu.org>
 
 	* files.texi (Format Conversion Piecemeal): Clarify
diff --git a/lispref/files.texi b/lispref/files.texi
index 659229681b..5af77fafc3 100644
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -2616,6 +2616,7 @@ first, before handlers for jobs such as remote file access.
 @code{process-file},
 @code{rename-file}, @code{set-file-modes}, @code{set-file-times},
 @code{set-visited-file-modtime}, @code{shell-command},
+@code{start-file-process},
 @code{substitute-in-file-name},@*
 @code{unhandled-file-name-directory},
 @code{vc-registered},
@@ -2660,6 +2661,7 @@ first, before handlers for jobs such as remote file access.
 @code{process-file},
 @code{rename-file}, @code{set-file-modes},
 @code{set-visited-file-modtime}, @code{shell-command},
+@code{start-file-process},
 @code{substitute-in-file-name},
 @code{unhandled-file-name-directory},
 @code{vc-regis@discretionary{}{}{}tered},
diff --git a/lispref/processes.texi b/lispref/processes.texi
index 81cac3e504..5e74d0e247 100644
--- a/lispref/processes.texi
+++ b/lispref/processes.texi
@@ -495,6 +495,23 @@ Process my-process finished
 @end smallexample
 @end defun
 
+@defun start-file-process name buffer-or-name program &rest args
+Like @code{start-process}, this function starts a new asynchronous
+subprocess running @var{program} in it.  The corresponding process
+object is returned.
+
+If @code{default-directory} corresponds to a file handler, that
+handler is invoked.  @var{program} runs then on a remote host which is
+identified by @code{default-directory}.  The local part of
+@code{default-directory} is the working directory of the subprocess.
+
+@var{program} and @var{program-args} might be file names.  They are not
+objects of file handler invocation.
+
+Some file handlers may not support @code{start-file-process} (for
+example @code{ange-ftp-hook-function}).  It returns then @code{nil}.
+@end defun
+
 @defun start-process-shell-command name buffer-or-name command &rest command-args
 This function is like @code{start-process} except that it uses a shell
 to execute the specified command.  The argument @var{command} is a shell
@@ -1309,7 +1326,7 @@ latter specifies one measured in milliseconds.  The two time periods
 thus specified are added together, and @code{accept-process-output}
 returns after that much time, whether or not there has been any
 subprocess output.
-  
+
 The argument @var{millisec} is semi-obsolete nowadays because
 @var{seconds} can be a floating point number to specify waiting a
 fractional number of seconds.  If @var{seconds} is 0, the function