procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Clarify doc strings of 'call-process' and 'call-process-region'

Browse source 
* src/callproc.c (Fcall_process, Fcall_process_region): Document
that the destination buffer can be specified by its name.
(Bug#60477)
This commit is contained in:
Eli Zaretskii 2023-01-02 13:52:25 +02:00
parent 4520f09dd8
commit b7ad0b4014
1 changed files with 3 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
src/callproc.c
View file

@ -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. Third argument DESTINATION specifies how to handle program's output.
(\"Output\" here means both standard output and standard error (\"Output\" here means both standard output and standard error
output.) output.)
If DESTINATION is a buffer, or t that stands for the current buffer, If DESTINATION is a buffer or the name of a buffer, or t (which stands for
it means insert output in that buffer before point. the current buffer), it means insert output in that buffer before point.
If DESTINATION is nil, it means discard output; 0 means discard If DESTINATION is nil, it means discard output; 0 means discard
and don't wait for the program to terminate. and don't wait for the program to terminate.
If DESTINATION is `(:file FILE)', where FILE is a file name string, 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 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 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). 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, BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
REAL-BUFFER says what to do with standard output, as above, REAL-BUFFER says what to do with standard output, as above,
while STDERR-FILE says what to do with standard error in the child. while STDERR-FILE says what to do with standard error in the child.