* process.texi (Asynchronous Processes):

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

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 1e5e94258b12e69d1a9bc1b3663c19e36584bc95..5c25f0945a9c4005026d9c661726b6aca07a48af 100644 (file)
--- 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 659229681b9cf312b00ea94ccb7b50f4902fbc3c..5af77fafc318b480977cd5ca90e70605c1b4f16a 100644 (file)
--- 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 81cac3e50466a20b85d2a18081ac33f2aea6895a..5e74d0e247fbbf4cadc8f41c052470459b9efb10 100644 (file)
--- 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