diff lispref/processes.texi @ 70034:db4c2d467e9a

Revision: [e-mail]/emacs--devo--0--patch-220 Creator: Michael Olson <[e-mail]> Improve tq.el. * lispref/processes.texi (Transaction Queues): Mention the new optional `delay-question' argument for `tq-enqueue'. * lisp/emacs-lisp/tq.el: Improve comments. (tq-queue-head-question): New accessor function. (tq-queue-head-regexp, tq-queue-head-closure, tq-queue-head-fn): Update for modified queue structure. (tq-queue-add): Accept `question' argument. (tq-queue-pop): If a question is pending, send it. (tq-enqueue): Accept new optional argument `delay-question'. If this is non-nil, and at least one other question is pending a response, queue the question rather than sending it immediately.

--- a/lispref/processes.texi	Sat Apr 15 18:51:38 2006 +0000
+++ b/lispref/processes.texi	Sun Apr 16 02:17:00 2006 +0000
@@ -1508,7 +1508,7 @@
 machine.
 @end defun
 
-@defun tq-enqueue queue question regexp closure fn
+@defun tq-enqueue queue question regexp closure fn &optional delay-question
 This function sends a transaction to queue @var{queue}.  Specifying the
 queue has the effect of specifying the subprocess to talk to.
 
@@ -1521,6 +1521,10 @@
 text at the end of the entire answer, but nothing before; that's how
 @code{tq-enqueue} determines where the answer ends.
 
+If the argument @var{delay-question} is non-nil, delay sending this
+question until the process has finished replying to any previous
+questions.  This produces more reliable results with some processes."
+
 The return value of @code{tq-enqueue} itself is not meaningful.
 @end defun