# HG changeset patch # User Chong Yidong # Date 1282682604 14400 # Node ID 88f25e07e4eb17a9f6805bf905d3b2166e02ab23 # Parent 4653f09a70cf643f74d7ee0eaa3484de29c6c292 Fix filter functions discussion in Lisp manual. * processes.texi (Filter Functions): Use `buffer-live-p' instead of `buffer-name' in the main text as well as in the example (Bug#3098). diff -r 4653f09a70cf -r 88f25e07e4eb doc/lispref/ChangeLog --- a/doc/lispref/ChangeLog Tue Aug 24 16:29:44 2010 -0400 +++ b/doc/lispref/ChangeLog Tue Aug 24 16:43:24 2010 -0400 @@ -1,3 +1,9 @@ +2010-08-24 Markus Triska + + * processes.texi (Filter Functions): Use `buffer-live-p' instead + of `buffer-name' in the main text as well as in the example + (Bug#3098). + 2010-08-22 Chong Yidong * nonascii.texi (Text Representations): diff -r 4653f09a70cf -r 88f25e07e4eb doc/lispref/processes.texi --- a/doc/lispref/processes.texi Tue Aug 24 16:29:44 2010 -0400 +++ b/doc/lispref/processes.texi Tue Aug 24 16:43:24 2010 -0400 @@ -1273,22 +1273,24 @@ filter. Such filter functions need to use @code{set-buffer} in order to be sure to insert in that buffer. To avoid setting the current buffer semipermanently, these filter functions must save and restore the -current buffer. They should also update the process marker, and in some -cases update the value of point. Here is how to do these things: +current buffer. They should also check whether the buffer is still +alive, update the process marker, and in some cases update the value +of point. Here is how to do these things: @smallexample @group (defun ordinary-insertion-filter (proc string) - (with-current-buffer (process-buffer proc) - (let ((moving (= (point) (process-mark proc)))) + (when (buffer-live-p (process-buffer proc)) + (with-current-buffer (process-buffer proc) + (let ((moving (= (point) (process-mark proc)))) @end group @group - (save-excursion - ;; @r{Insert the text, advancing the process marker.} - (goto-char (process-mark proc)) - (insert string) - (set-marker (process-mark proc) (point))) - (if moving (goto-char (process-mark proc)))))) + (save-excursion + ;; r{Insert the text, advancing the process marker.} + (goto-char (process-mark proc)) + (insert string) + (set-marker (process-mark proc) (point))) + (if moving (goto-char (process-mark proc))))))) @end group @end smallexample @@ -1315,12 +1317,6 @@ match data. Now Emacs does this automatically for filter functions; they never need to do it explicitly. @xref{Match Data}. - A filter function that writes the output into the buffer of the -process should check whether the buffer is still alive. If it tries to -insert into a dead buffer, it will get an error. The expression -@code{(buffer-name (process-buffer @var{process}))} returns @code{nil} -if the buffer is dead. - The output to the function may come in chunks of any size. A program that produces the same output twice in a row may send it as one batch of 200 characters one time, and five batches of 40 characters the next. If