comparison lisp/code-process.el @ 837:0490271de7d8

[xemacs-hg @ 2002-05-14 05:30:30 by adrian] [PATCH] xemacs-21.5: Process-related docstring improvements spurred by Norbert Koch <vg9ryfer.fsf@smtprelay.t-online.de>
author adrian
date Tue, 14 May 2002 05:30:36 +0000
parents 943eaba38521
children 2b6fa2618f76
comparison
equal deleted inserted replaced
836:8f668d99fea6 837:0490271de7d8
45 (defun call-process (program &optional infile buffer displayp &rest args) 45 (defun call-process (program &optional infile buffer displayp &rest args)
46 "Call PROGRAM synchronously in separate process. 46 "Call PROGRAM synchronously in separate process.
47 The program's input comes from file INFILE (nil means `/dev/null'). 47 The program's input comes from file INFILE (nil means `/dev/null').
48 Insert output in BUFFER before point; t means current buffer; 48 Insert output in BUFFER before point; t means current buffer;
49 nil for BUFFER means discard it; 0 means discard and don't wait. 49 nil for BUFFER means discard it; 0 means discard and don't wait.
50 If BUFFER is a string, then find or create a buffer with that name,
51 then insert the output in that buffer, before point.
50 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case, 52 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
51 REAL-BUFFER says what to do with standard output, as above, 53 REAL-BUFFER says what to do with standard output, as above,
52 while STDERR-FILE says what to do with standard error in the child. 54 while STDERR-FILE says what to do with standard error in the child.
53 STDERR-FILE may be nil (discard standard error output), 55 STDERR-FILE may be nil (discard standard error output),
54 t (mix it with ordinary output), or a file name string. 56 t (mix it with ordinary output), or a file name string.
90 "Send text from START to END to a synchronous process running PROGRAM. 92 "Send text from START to END to a synchronous process running PROGRAM.
91 Delete the text if fourth arg DELETEP is non-nil. 93 Delete the text if fourth arg DELETEP is non-nil.
92 94
93 Insert output in BUFFER before point; t means current buffer; 95 Insert output in BUFFER before point; t means current buffer;
94 nil for BUFFER means discard it; 0 means discard and don't wait. 96 nil for BUFFER means discard it; 0 means discard and don't wait.
97 If BUFFER is a string, then find or create a buffer with that name,
98 then insert the output in that buffer, before point.
95 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case, 99 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
96 REAL-BUFFER says what to do with standard output, as above, 100 REAL-BUFFER says what to do with standard output, as above,
97 while STDERR-FILE says what to do with standard error in the child. 101 while STDERR-FILE says what to do with standard error in the child.
98 STDERR-FILE may be nil (discard standard error output), 102 STDERR-FILE may be nil (discard standard error output),
99 t (mix it with ordinary output), or a file name string. 103 t (mix it with ordinary output), or a file name string.
143 (defun start-process (name buffer program &rest program-args) 147 (defun start-process (name buffer program &rest program-args)
144 "Start a program in a subprocess. Return the process object for it. 148 "Start a program in a subprocess. Return the process object for it.
145 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS 149 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS
146 NAME is name for process. It is modified if necessary to make it unique. 150 NAME is name for process. It is modified if necessary to make it unique.
147 BUFFER is the buffer or (buffer-name) to associate with the process. 151 BUFFER is the buffer or (buffer-name) to associate with the process.
148 Process output goes at end of that buffer, unless you specify 152 Process output goes at end of that buffer, unless you specify
149 an output stream or filter function to handle the output. 153 an output stream or filter function to handle the output.
150 BUFFER may be also nil, meaning that this process is not associated 154 BUFFER may also be nil, meaning that this process is not associated
151 with any buffer 155 with any buffer.
152 Third arg is program file name. It is searched for as in the shell. 156 Third arg is program file name. It is searched for as in the shell.
153 Remaining arguments are strings to give program as arguments. 157 Remaining arguments are strings to give program as arguments.
154 INCODE and OUTCODE specify the coding-system objects used in input/output 158 INCODE and OUTCODE specify the coding-system objects used in input/output
155 from/to the process." 159 from/to the process."
156 (let (cs-r cs-w) 160 (let (cs-r cs-w)