Mercurial > emacs

--- a/lispref/ChangeLog	Sat Jul 07 11:17:51 2007 +0000
+++ b/lispref/ChangeLog	Sat Jul 07 11:18:32 2007 +0000
@@ -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
--- a/lispref/files.texi	Sat Jul 07 11:17:51 2007 +0000
+++ b/lispref/files.texi	Sat Jul 07 11:18:32 2007 +0000
@@ -2616,6 +2616,7 @@
 @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 @@
 @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},
--- a/lispref/processes.texi	Sat Jul 07 11:17:51 2007 +0000
+++ b/lispref/processes.texi	Sat Jul 07 11:18:32 2007 +0000
@@ -495,6 +495,23 @@
 @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 @@
 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