inconsistent doc for call-process-regione

inconsistent doc for call-process-regione

[Francesco Potorti`]

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.

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>