Re: `call-process', to a string

[Garreau\, Alexandre]

Le 30/10/2018 à 09h19, Eli Zaretskii a écrit :
>> From: "Basil L. Contovounesios" <address@hidden>
>> Date: Tue, 30 Oct 2018 02:25:36 +0000
>> Cc: emacs-devel <address@hidden>
>> 
>> >> Insert output in DESTINATION before point; t means current buffer; nil 
>> >> for DESTINATION
>> >>  means discard it; 0 means discard and don’t wait; and ‘(:file FILE)’, 
>> >> where
>> >>  FILE is a file name string, means that it should be written to that file
>> >>  (if the file already exists it is overwritten).
>> >> DESTINATION can also have the form (REAL-BUFFER STDERR-FILE); in that 
>> >> case,
>> >> REAL-BUFFER says what to do with standard output, as above,
>> >> while STDERR-FILE says what to do with standard error in the child.
>> >> STDERR-FILE may be nil (discard standard error output),
>> >> t (mix it with ordinary output), or a file name string.
>> >
>> > I also notice it is not documented that DESTINATION may be a buffer, in
>> > which case the output is inserted in the said buffer (I checked).
>> 
>> Indeed this does not seem to be documented in the docstring of
>> call-process
>
> ??? You have just quoted the part where it does document that:
>
>  Insert output in DESTINATION before point; t means current buffer;
>
> Will the following minor change make that abundantly clear?
>
>  Insert output in buffer DESTINATION before point; t means current buffer;

Yes it does.

> (What else can "insert in ... before point" mean, in Emacs?)

In this docstring, it may be interpreted as a filename referred by a
string, or something referred by another value (the two-streams list).
I find it more clear if precising anyway, at this function may not
output to buffer.