From 3452df9e69e96dda18f990c57572b312c56f492d Mon Sep 17 00:00:00 2001 From: "Kim F. Storm" Date: Thu, 16 Jan 2003 12:59:18 +0000 Subject: [PATCH] (set-process-filter): Document unibyte/multibyte-ness of string argument. --- src/process.c | 14 +++++++++++--- 1 file 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; { -- 2.20.1