(x_term_init): Unblock input around call1.

[bpt/emacs.git] / lispref / processes.texi

diff --git a/lispref/processes.texi b/lispref/processes.texi
index 16aa65a..289ae42 100644 (file)
--- a/lispref/processes.texi
+++ b/lispref/processes.texi
@@ -1,6 +1,7 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.

-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998 Free Software Foundation, Inc. 
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999
+@c   Free Software Foundation, Inc. 

 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/processes
 @node Processes, Display, Abbrevs, Top
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/processes
 @node Processes, Display, Abbrevs, Top


@@ -314,7 +315,7 @@ as it comes in.  For details, see the description of
 @code{call-process}, above.  If @var{destination} is the integer 0,
 @code{call-process-region} discards the output and returns @code{nil}
 immediately, without waiting for the subprocess to finish (this only
 @code{call-process}, above.  If @var{destination} is the integer 0,
 @code{call-process-region} discards the output and returns @code{nil}
 immediately, without waiting for the subprocess to finish (this only

-works if asynchronous subprocess are supported).
+works if asynchronous subprocesses are supported).

 
 The remaining arguments, @var{args}, are strings that specify command
 line arguments for the program.
 
 The remaining arguments, @var{args}, are strings that specify command
 line arguments for the program.


@@ -365,7 +366,6 @@ inputinput@point{}
 @end defun
 
 @defun shell-command-to-string command
 @end defun
 
 @defun shell-command-to-string command

-@tindex shell-command-to-string

 This function executes @var{command} (a string) as a shell command,
 then returns the command's output as a string.
 @end defun
 This function executes @var{command} (a string) as a shell command,
 then returns the command's output as a string.
 @end defun


@@ -594,7 +594,6 @@ This function returns the name of @var{process}.
 @end defun
 
 @defun process-contact process
 @end defun
 
 @defun process-contact process

-@tindex process-contact

 This function returns @code{t} for an ordinary child process, and
 @code{(@var{hostname} @var{service})} for a net connection
 (@pxref{Network}).
 This function returns @code{t} for an ordinary child process, and
 @code{(@var{hostname} @var{service})} for a net connection
 (@pxref{Network}).


@@ -663,7 +662,6 @@ instead of a terminal (see @code{process-connection-type} in
 @end defun
 
 @defun process-coding-system process
 @end defun
 
 @defun process-coding-system process

-@tindex process-coding-system

 This function returns a cons cell describing the coding systems in use
 for decoding output from @var{process} and for encoding input to
 @var{process} (@pxref{Coding Systems}).  The value has this form:
 This function returns a cons cell describing the coding systems in use
 for decoding output from @var{process} and for encoding input to
 @var{process} (@pxref{Coding Systems}).  The value has this form:


@@ -674,7 +672,6 @@ for decoding output from @var{process} and for encoding input to
 @end defun
 
 @defun set-process-coding-system process decoding-system encoding-system
 @end defun
 
 @defun set-process-coding-system process decoding-system encoding-system

-@tindex set-process-coding-system

 This function specifies the coding systems to use for subsequent output
 from and input to @var{process}.  It will use @var{decoding-system} to
 decode subprocess output, and @var{encoding-system} to encode subprocess
 This function specifies the coding systems to use for subsequent output
 from and input to @var{process}.  It will use @var{decoding-system} to
 decode subprocess output, and @var{encoding-system} to encode subprocess


@@ -878,7 +875,7 @@ which is called the associated buffer of the process, or a function
 called the @dfn{filter function} can be called to act on the output.  If
 the process has no buffer and no filter function, its output is
 discarded.
 called the @dfn{filter function} can be called to act on the output.  If
 the process has no buffer and no filter function, its output is
 discarded.

-
+ 

   Output from a subprocess can arrive only while Emacs is waiting: when
 reading terminal input, in @code{sit-for} and @code{sleep-for}
 (@pxref{Waiting}), and in @code{accept-process-output} (@pxref{Accepting
   Output from a subprocess can arrive only while Emacs is waiting: when
 reading terminal input, in @code{sit-for} and @code{sleep-for}
 (@pxref{Waiting}), and in @code{accept-process-output} (@pxref{Accepting


@@ -888,6 +885,13 @@ process and only then specify its buffer or filter function; no output
 can arrive before you finish, if the code in between does not call any
 primitive that waits.
 
 can arrive before you finish, if the code in between does not call any
 primitive that waits.
 

+  It is impossible to separate the standard output and standard error
+streams of the subprocess, because Emacs normally spawns the subprocess
+inside a pseudo-TTY, and a pseudo-TTY has only one output channel.  If
+you want to keep the output to those streams separate, you should
+redirect one of them to a file--for example, by using an appropriate
+shell command.
+

   Subprocess output is normally decoded using a coding system before the
 buffer or filter function receives it, much like text read from a file.
 You can use @code{set-process-coding-system} to specify which coding
   Subprocess output is normally decoded using a coding system before the
 buffer or filter function receives it, much like text read from a file.
 You can use @code{set-process-coding-system} to specify which coding