Mercurial > emacs
comparison lispref/processes.texi @ 82092:38bfa1de0aca
* 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'.
author | Michael Albinus <michael.albinus@gmx.de> |
---|---|
date | Tue, 24 Jul 2007 20:37:43 +0000 |
parents | 326bae23bda1 |
children | f59dca8510d0 f55f9811f5d7 |
comparison
equal
deleted
inserted
replaced
82091:535e5fa4eca9 | 82092:38bfa1de0aca |
---|---|
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 |