comparison 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.

70033:257bb51424b3

capable of sending and receiving streams of bytes.  It may be a child
process, or it may be a TCP connection to a server, possibly on another
machine.
@end defun

@defun tq-enqueue queue question regexp closure fn
This function sends a transaction to queue @var{queue}.  Specifying the
queue has the effect of specifying the subprocess to talk to.

The argument @var{question} is the outgoing message that starts the
transaction.  The argument @var{fn} is the function to call when the

@var{closure}, and the answer received.

The argument @var{regexp} is a regular expression that should match
text at the end of the entire answer, but nothing before; that's how
@code{tq-enqueue} determines where the answer ends.

The return value of @code{tq-enqueue} itself is not meaningful.
@end defun

@defun tq-close queue

70034:db4c2d467e9a

capable of sending and receiving streams of bytes.  It may be a child
process, or it may be a TCP connection to a server, possibly on another
machine.
@end defun

@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.

The argument @var{question} is the outgoing message that starts the
transaction.  The argument @var{fn} is the function to call when the

@var{closure}, and the answer received.

The argument @var{regexp} is a regular expression that should match
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

@defun tq-close queue