Re: `call-process', to a string [Was: Re: Automatically set eww-download-directory according xdg dir]

[Basil L. Contovounesios]

Eli Zaretskii <address@hidden> writes:

>> 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;

Mea culpa.  That's what I get for writing emails past 02:00.

> Will the following minor change make that abundantly clear?
>
>  Insert output in buffer DESTINATION before point; t means current buffer;
>
> (What else can "insert in ... before point" mean, in Emacs?)

You're right, it's unambiguous.  Either way, thank you for clarifying
the docstring on the emacs-26 branch; it's a welcome improvement.

-- 
Basil