# HG changeset patch
# User Michael Albinus <michael.albinus@gmx.de>
# Date 1185309463 0
# Node ID 38bfa1de0aca898dd07bf752428d0ea648e73d0e
# Parent  535e5fa4eca90ff071982b6dda63d12316afb8e3
* processes.texi (Synchronous Processes): Add
`process-file-shell-command',
(Asynchronous Processes): Mention restricted use of
`process-filter' and `process-sentinel' in
`start-file-process'. Add `start-file-process-shell-command'.

diff -r 535e5fa4eca9 -r 38bfa1de0aca lispref/ChangeLog
--- a/lispref/ChangeLog	Tue Jul 24 13:15:04 2007 +0000
+++ b/lispref/ChangeLog	Tue Jul 24 20:37:43 2007 +0000
@@ -1,3 +1,11 @@
+2007-07-24  Michael Albinus  <michael.albinus@gmx.de>
+
+	* processes.texi (Synchronous Processes): Add
+	`process-file-shell-command',
+	(Asynchronous Processes): Mention restricted use of
+	`process-filter' and `process-sentinel' in
+	`start-file-process'.  Add `start-file-process-shell-command'.
+
 2007-07-17  Michael Albinus  <michael.albinus@gmx.de>
 
 	* files.texi (Magic File Names): Introduce optional parameter
diff -r 535e5fa4eca9 -r 38bfa1de0aca lispref/processes.texi
--- a/lispref/processes.texi	Tue Jul 24 13:15:04 2007 +0000
+++ b/lispref/processes.texi	Tue Jul 24 20:37:43 2007 +0000
@@ -432,6 +432,12 @@
 are handled as in @code{call-process}.
 @end defun
 
+@defun process-file-shell-command command &optional infile destination display &rest args
+This function is like @code{call-process-shell-command}, but uses
+@code{process-file} internally.  Depending on @code{default-directory},
+@var{command} can be executed also on remote hosts.
+@end defun
+
 @defun shell-command-to-string command
 This function executes @var{command} (a string) as a shell command,
 then returns the command's output as a string.
@@ -508,6 +514,10 @@
 @var{program} and @var{program-args} might be file names.  They are not
 objects of file handler invocation.
 
+Depending on the implementation of the file handler, it might not be
+possible to apply @code{process-filter} or @code{process-sentinel} to
+the resulting process object (@pxref{Filter Functions}, @pxref{Sentinels}).
+
 Some file handlers may not support @code{start-file-process} (for
 example @code{ange-ftp-hook-function}).  It returns then @code{nil}.
 @end defun
@@ -528,6 +538,12 @@
 Arguments}.
 @end defun
 
+@defun start-file-process-shell-command name buffer-or-name command &rest command-args
+This function is like @code{start-process-shell-command}, but uses
+@code{start-file-process} internally.  By this, @var{command} can be
+executed also on remote hosts, depending on @code{default-directory}.
+@end defun
+
 @defvar process-connection-type
 @cindex pipes
 @cindex @acronym{PTY}s