From: Eli Zaretskii Date: Mon, 2 Jan 2023 11:52:25 +0000 (+0200) Subject: ; Clarify doc strings of 'call-process' and 'call-process-region' X-Git-Tag: emacs-29.0.90~866 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b7ad0b40148bd5905497a4c05fced4e0b9099812;p=emacs.git ; Clarify doc strings of 'call-process' and 'call-process-region' * src/callproc.c (Fcall_process, Fcall_process_region): Document that the destination buffer can be specified by its name. (Bug#60477) --- diff --git a/src/callproc.c b/src/callproc.c index 7208ceb5d2f..5e1e1a8cc0a 100644 --- a/src/callproc.c +++ b/src/callproc.c @@ -259,8 +259,8 @@ input come from an Emacs buffer, use `call-process-region' instead. Third argument DESTINATION specifies how to handle program's output. (\"Output\" here means both standard output and standard error output.) -If DESTINATION is a buffer, or t that stands for the current buffer, - it means insert output in that buffer before point. +If DESTINATION is a buffer or the name of a buffer, or t (which stands for +the current buffer), it means insert output in that buffer before point. If DESTINATION is nil, it means discard output; 0 means discard and don't wait for the program to terminate. If DESTINATION is `(:file FILE)', where FILE is a file name string, @@ -1055,6 +1055,7 @@ Insert output in BUFFER before point; t means current buffer; nil for BUFFER 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). +BUFFER can be a string which is the name of a buffer. BUFFER 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.