diff options
author | Kim F. Storm <[email protected]> | 2003-01-16 12:59:18 +0000 |
---|---|---|
committer | Kim F. Storm <[email protected]> | 2003-01-16 12:59:18 +0000 |
commit | 3452df9e69e96dda18f990c57572b312c56f492d (patch) | |
tree | 43668398edbec3028eabc523a7c33aa96cce1bbb | |
parent | cd7df9c00b80775143ab73a8da613ff466a6444c (diff) |
(set-process-filter): Document unibyte/multibyte-ness of string argument.
-rw-r--r-- | src/process.c | 14 |
1 files changed, 11 insertions, 3 deletions
diff --git a/src/process.c b/src/process.c index e90382b08b..1998e84542 100644 --- a/src/process.c +++ b/src/process.c @@ -844,10 +844,18 @@ DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter, 2, 2, 0, doc: /* Give PROCESS the filter function FILTER; nil means no filter. t means stop accepting output from the process. -When a process has a filter, each time it does output -the entire string of output is passed to the filter. + +When a process has a filter, its buffer is not used for output. +Instead, each time it does output, the entire string of output is +passed to the filter. + The filter gets two arguments: the process and the string of output. -If the process has a filter, its buffer is not used for output. */) +The string argument is normally a multibyte string, except: +- if the process' input coding system is no-conversion or raw-text, + it is a unibyte string (the non-converted input), or else +- if `default-enable-multibyte-characters' is nil, it is a unibyte + string (the result of converting the decoded input multibyte + string to unibyte with `string-make-unibyte'). */) (process, filter) register Lisp_Object process, filter; { |