(set-process-filter): Document unibyte/multibyte-ness of string argument.
authorKim F. Storm <storm@cua.dk>
Thu, 16 Jan 2003 12:59:18 +0000 (12:59 +0000)
committerKim F. Storm <storm@cua.dk>
Thu, 16 Jan 2003 12:59:18 +0000 (12:59 +0000)
src/process.c

index e90382b..1998e84 100644 (file)
@@ -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;
 {