Re: inconsistent doc for call-process-regione

[Kevin Rodgers]

Francesco Potorti` wrote:

> In GNU Emacs 21.3.1 (i686-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
>
> The doc string for call-process says:
>
> |Insert output in BUFFER before point; t means current buffer;
> | nil for BUFFER means discard it; 0 means discard and don't wait.
>
> But later it says:
>
> |If BUFFER is nil, `call-process-region' returns immediately with value nil.
> |Otherwise it waits for PROGRAM to terminate
> |and returns a numeric exit status or a signal description string.
>
> If I am not wrong, these are contradictory.  If they are not, then I do
> not understand, and probably they should be cleared.

I don't think they are contradictory.  The value of BUFFER determines 2 things
(3 actually): what is done with the process's output, and what value is returned
(as well as whether that value is returned immediately or when the process
terminates).

--
<a href="mailto:&lt;kevin.rodgers&#64;ihs.com&gt;";>Kevin Rodgers</a>