comparison lispref/processes.texi @ 90996:f55f9811f5d7

Merge from emacs--devo--0 Patches applied: * emacs--devo--0 (patch 824-831) - Update from CVS - Merge from emacs--rel--22 * emacs--rel--22 (patch 70-74) - Update from CVS Revision: emacs@sv.gnu.org/emacs--unicode--0--patch-238
author Miles Bader <miles@gnu.org>
date Fri, 27 Jul 2007 10:52:18 +0000
parents 988f1edc9674 38bfa1de0aca
children aaccdab0ee26
comparison
equal deleted inserted replaced
90995:9a391d85a79f 90996:f55f9811f5d7
430 in a separate process. The final arguments @var{args} are additional 430 in a separate process. The final arguments @var{args} are additional
431 arguments to add at the end of @var{command}. The other arguments 431 arguments to add at the end of @var{command}. The other arguments
432 are handled as in @code{call-process}. 432 are handled as in @code{call-process}.
433 @end defun 433 @end defun
434 434
435 @defun process-file-shell-command command &optional infile destination display &rest args
436 This function is like @code{call-process-shell-command}, but uses
437 @code{process-file} internally. Depending on @code{default-directory},
438 @var{command} can be executed also on remote hosts.
439 @end defun
440
435 @defun shell-command-to-string command 441 @defun shell-command-to-string command
436 This function executes @var{command} (a string) as a shell command, 442 This function executes @var{command} (a string) as a shell command,
437 then returns the command's output as a string. 443 then returns the command's output as a string.
438 @end defun 444 @end defun
439 445
506 @code{default-directory} is the working directory of the subprocess. 512 @code{default-directory} is the working directory of the subprocess.
507 513
508 @var{program} and @var{program-args} might be file names. They are not 514 @var{program} and @var{program-args} might be file names. They are not
509 objects of file handler invocation. 515 objects of file handler invocation.
510 516
517 Depending on the implementation of the file handler, it might not be
518 possible to apply @code{process-filter} or @code{process-sentinel} to
519 the resulting process object (@pxref{Filter Functions}, @pxref{Sentinels}).
520
511 Some file handlers may not support @code{start-file-process} (for 521 Some file handlers may not support @code{start-file-process} (for
512 example @code{ange-ftp-hook-function}). It returns then @code{nil}. 522 example @code{ange-ftp-hook-function}). It returns then @code{nil}.
513 @end defun 523 @end defun
514 524
515 @defun start-process-shell-command name buffer-or-name command &rest command-args 525 @defun start-process-shell-command name buffer-or-name command &rest command-args
524 as wildcards in the arguments. It follows that if you include an 534 as wildcards in the arguments. It follows that if you include an
525 arbitrary user-specified arguments in the command, you should quote it 535 arbitrary user-specified arguments in the command, you should quote it
526 with @code{shell-quote-argument} first, so that any special shell 536 with @code{shell-quote-argument} first, so that any special shell
527 characters do @emph{not} have their special shell meanings. @xref{Shell 537 characters do @emph{not} have their special shell meanings. @xref{Shell
528 Arguments}. 538 Arguments}.
539 @end defun
540
541 @defun start-file-process-shell-command name buffer-or-name command &rest command-args
542 This function is like @code{start-process-shell-command}, but uses
543 @code{start-file-process} internally. By this, @var{command} can be
544 executed also on remote hosts, depending on @code{default-directory}.
529 @end defun 545 @end defun
530 546
531 @defvar process-connection-type 547 @defvar process-connection-type
532 @cindex pipes 548 @cindex pipes
533 @cindex @acronym{PTY}s 549 @cindex @acronym{PTY}s